json_dataguide不支持直接解析clob中的json数组，必须先将clob显式转为json类型（如json('['||clob||']')或to_json），且需配合where col is json校验；真正解析数组内容应直接使用json_table。
json_dataguide 在 oracle 12c+ 中不支持直接解析 clob 中的 json 数组结构
oracle 的 json_dataguide 函数只接受 json 类型（即带 is json 约束的列）或字符串字面量，**不能直接对未校验的 clob 值调用**。如果你传入一个纯 clob（哪怕内容是合法 json），会报错：ora-40441: json syntax error 或 ora-40478: output value too large（尤其当 clob > 4000 字符且未显式转为 json 类型时）。
根本原因是：JSON_DATAGUIDE 内部要求输入已通过 JSON 语法预检，而 CLOB 是泛型大对象，Oracle 不会在函数调用时自动触发 JSON 解析和验证。
必须先将 CLOB 转为 JSON 类型，再用 JSON_DATAGUIDE
正确路径是：CLOB → 显式转换为 JSON 类型（触发语法检查）→ JSON_DATAGUIDE。关键在转换步骤，有且仅有两种安全方式：
- 用
TO_JSON(clob_column)（Oracle 21c+ 引入，推荐，自动校验并转成 JSON 类型） - 用
JSON('{' || clob_column || '}')包裹后强转（仅适用于顶层是对象；若原 CLOB 是 JSON 数组[...]，需改用JSON('[' || clob_column || ']')，但注意这会嵌套一层）
示例（假设表 t 有 CLOB 列 payload，内容为 JSON 数组 [{"id":1,"name":"a"},{"id":2,"name":"b"}]）：
SELECT JSON_DATAGUIDE(
JSON('[' || payload || ']') -- 把原始 CLOB 数组包成合法 JSON 输入
) AS guide
FROM t
WHERE payload IS NOT NULL AND payload IS JSON;
⚠️ 注意：payload IS JSON 这个条件不能省——它强制 Oracle 在扫描时做轻量级 JSON 校验，避免 JSON() 构造时崩溃；没有它，遇到非法 JSON 会直接报错中断查询。
JSON_DATAGUIDE 输出的是 JSON 文档，不是关系表，别指望直接 SELECT *
JSON_DATAGUIDE 返回类型是 CLOB（内容为 JSON 格式的结构描述），例如：[{"o:path":"$.id","type":"number","o:length":22},{"o:path":"$.name","type":"string","o:length":40}]。它不是视图，也不能用 JSON_TABLE 直接展开。
审查 Next.js App Router 代码库，检查 React Server Component 边界错误、请求瀑布、客户端/服务端反模式以及 Core Web Vitals 风险...
若你要提取字段路径用于后续解析，得用 JSON_VALUE 或 JSON_QUERY 手动抽取：
SELECT
JSON_VALUE(guide, '$[0]."o:path"') AS path1,
JSON_VALUE(guide, '$[0].type') AS type1
FROM (
SELECT JSON_DATAGUIDE(JSON('[' || payload || ']')) AS guide
FROM t
WHERE payload IS JSON
);
更实用的做法是：把 JSON_DATAGUIDE 结果存到临时表，再用 JSON_TABLE 解析成行 —— 但要注意输出长度限制：JSON_DATAGUIDE 默认截断为 4000 字符，数组字段多时会丢信息，此时必须加 RETURNING CLOB：
JSON_DATAGUIDE(JSON('[' || payload || ']') RETURNING CLOB)
真正想“解析 JSON 数组内容”？别绕路用 JSON_DATAGUIDE，直接上 JSON_TABLE
如果你的真实目标是把 CLOB 里的 JSON 数组转成行数据（比如取出每个对象的 id 和 name），JSON_DATAGUIDE 是冗余环节。直接用 JSON_TABLE 更快、更稳：
SELECT jt.id, jt.name
FROM t,
JSON_TABLE(
payload, '$[*]' -- 注意：payload 必须 IS JSON，否则报 ORA-40441
COLUMNS (
id NUMBER PATH '$.id',
name VARCHAR2(100) PATH '$.name'
)
) jt
WHERE payload IS JSON;
这个写法跳过了结构推测，直奔数据提取。唯一硬性前提：CLOB 列必须带 IS JSON 约束（建表时加，或查询时用 WHERE col IS JSON 过滤），否则 Oracle 不允许在 JSON_TABLE 中引用它。
最易被忽略的一点：Oracle 对 JSON 数组的路径定位非常严格。'$[*]' 只匹配顶层数组元素；如果 CLOB 内容是 {"data":[...]}，路径就得写成 '$.data[*]'，且 JSON_TABLE 的第一个参数必须是完整 JSON 对象（即不能只传数组片段）。这时候，JSON('{' || payload || '}') 就真派上用场了——但仅用于构造上下文，而非驱动结构发现。
