oracle 21c 必须声明 json 类型参数才能启用原生 json 解析优势；错误使用 clob/varchar2 会导致类型校验失效、索引不可用及静默字符串处理；应优先用 json_exists 预检路径、json_table 提取多字段或数组，避免 json_value 误判 null。
参数必须声明为 JSON 类型，不能用 CLOB 或 VARCHAR2
Oracle 21c 支持原生 JSON 数据类型，这是解析入参的前提。如果仍用 CLOB 或 VARCHAR2 声明参数，后续所有 JSON_VALUE、JSON_QUERY 等函数虽能运行，但会失去类型安全校验和二进制解析优势，且无法利用 JSON 列上的函数索引。
正确写法：json_input JSON；错误写法：json_input CLOB、json_input VARCHAR2(32767)。
注意：即使传入的是合法 JSON 字符串，若参数类型不是 JSON，Oracle 不会自动转换——它会静默当作普通字符串处理，导致 JSON_EXISTS 返回 FALSE、JSON_VALUE 返回 NULL，且不报错。
用 JSON_EXISTS 预检路径是否存在，别依赖 JSON_VALUE 的 NULL 判断
JSON_VALUE 在路径不存在或值为 null 时都返回 NULL，无法区分“字段没传”和“字段传了 null”。业务逻辑常需区分这两种情况，比如 “用户未填手机号” 和 “用户明确填了 null 表示放弃”。
推荐组合：JSON_EXISTS(json_input, '$.mobile') 先确认字段存在，再用 JSON_VALUE(json_input, '$.mobile' RETURNING VARCHAR2) 提取值。
- 路径含中文或特殊字符必须用双引号包裹：
'$.["收货地址"]'✅，'$.收货地址'❌ - 数组索引从 0 开始：
'$[0].name'提取第一个元素的 name 字段 - 路径错误（如拼写错、层级错）时
JSON_EXISTS返回FALSE，比靠NULL推断更可靠
多字段或嵌套结构优先用 JSON_TABLE，不是连写 JSON_VALUE
从同一段 JSON 中提取超过 2–3 个字段，尤其涉及不同层级（如 $.user.name 和 $.order.items[0].price），硬写多个 JSON_VALUE 调用不仅难维护，还会重复解析整段 JSON——Oracle 21c 的 JSON 引擎不会缓存中间结果。
JSON_TABLE 是一次性展开成行集的标准解法，性能更好、语义更清晰：
SELECT jt.name, jt.email, jt.amount
FROM your_table,
JSON_TABLE(json_input, '$'
COLUMNS (
name VARCHAR2(100) PATH '$.user.name',
email VARCHAR2(255) PATH '$.user.email',
amount NUMBER PATH '$.order.total'
)
) jt;
关键点：
-
JSON_TABLE必须配合FROM子句使用，不能直接赋值给变量 - 路径为空或类型不匹配时，对应列返回
NULL，不会中断整个查询 - 若 JSON 中
$.order为null，则amount列为NULL，这是预期行为
数组元素展开必须用 JSON_TABLE 或 JSON_QUERY + 循环，OPENJSON 不是 Oracle 的函数
SQL Server 的 OPENJSON 在 Oracle 里不存在。想把 JSON 数组（如 [{"id":1},{"id":2}]）展开成多行，只有两个可靠方式：
一是用 JSON_TABLE 直接展开：
SELECT jt.id
FROM JSON_TABLE(json_input, '$[*]'
COLUMNS (id NUMBER PATH '$.id')
) jt;
二是用 JSON_QUERY 提取数组片段，再结合 JSON_TABLE 或 PL/SQL 循环处理：
-
JSON_QUERY(json_input, '$.items')返回子 JSON（类型仍是JSON），可作为下一层解析输入 - 别用
JSON_VALUE提取数组——它只返回标量，对数组返回NULL - PL/SQL 中循环处理需搭配
JSON_ARRAY_T或JSON_OBJECT_T解析器，但性能不如纯 SQL 的JSON_TABLE
最易被忽略的一点：Oracle 21c 的 JSON 函数全部基于 OSON 二进制格式解析，但前提是输入参数类型为 JSON。一旦参数声明为 CLOB，哪怕内容完全合法，所有 JSON 函数都退化为文本模式解析——既慢，又不支持函数索引，还可能在 Unicode 处理上出偏差。
