Java高效解析Oracle JSON_B数据：OracleJsonValue驱动

在 Oracle 19c 中，JDBC 操作原生 JSON 列不能直接使用 rs.getString()，而是需要显式调用 rs.getObject("col", String.class)。网上流传的“OracleJsonValue 驱动”实际上是误解：JSON_VALUE 是数据库服务端的内置函数，与 JDBC 驱动无关。本质上是两套不同机制，很多人混淆了 SQL 解析能力和驱动行为。

为什么 Oracle 19c 中 rs.getString("col") 会报错或返回乱码

Oracle 19c 将 JSON 定义为独立的 SQL 类型，JDBC 驱动（ojdbc8 19.19 及以上版本）默认不会自动将其转换为字符串。直接调用 rs.getString("j") 大概率会触发 SQLException: cannot convert to string，或者底层返回十六进制二进制内容（如 0x7B2261223A317D），解码后乱码。

根本原因并非字符集——即使数据库为 AL32UTF8，同样会报错。问题在于驱动未启用 JSON 类型协议支持。

• rs.getObject("j", String.class) 是唯一被 ojdbc8u3+ 原生支持的正确写法。
• rs.getObject("j") 返回的是 oracle.sql.json.OracleJsonStructure 对象，无法直接 toString() 或强制转换。
• 低版本驱动（如 ojdbc7）完全不识别 JSON 类型，会直接报 ORA-00902: invalid datatype。

必须显式传入 SQLType.JSON，不能依赖驱动自动推断

JDBC 规范明确：对于 JSON、XML 等扩展 SQL 类型，必须通过带 SQLType 参数的 getObject 方法显式声明目标类型。否则驱动会回退到通用逻辑，大概率出错。

正确的代码为：

String jsonStr = rs.getObject("j", String.class); //  使用 SQLType.JSON 协议

注意：String.class 是 JDBC 驱动唯一保证支持的 target type；若传入 JsonObject.class，会直接抛出 SQLFeatureNotSupportedException。

• 字段为 NULL 时，rs.getObject("j", String.class) 返回 null，而非空字符串。
• 必须使用 ojdbc8 ≥ 19.19（即 ojdbc8u3+），早期版本没有 SQLType.JSON 常量。
• 不要尝试 rs.getNString() 或 rs.getClob()，它们均不适用于原生 JSON 列。

在 SQL 层解析 JSON 应使用 JSON_VALUE / JSON_QUERY，而非 JDBC 驱动

所谓“OracleJsonValue 驱动”纯属讹传。Oracle 提供的是服务端 JSON 解析函数——JSON_VALUE、JSON_QUERY、JSON_TABLE——它们在 SQL 引擎内执行，与 JDBC 驱动版本无关（数据库版本 12c+ 即可）。

例如，要从 {"name":"Alice"} 中提取 name 字段，直接在 SQL 中写：

SELECT JSON_VALUE(j, '$.name' RETURNING VARCHAR2(100)) FROM my_table

JDBC 层拿到的就是普通字符串，无需额外解析。

• JSON_VALUE 返回标量（字符串/数字/布尔），JSON_QUERY 返回 JSON 片段（对象或数组）。
• 路径表达式必须合法，否则查询会报 ORA-40442: JSON syntax error。
• 若 JSON 列内容可能非法，先加 WHERE j IS JSON 过滤，避免运行时错误。

复杂嵌套结构优先使用 JSON_TABLE 展开为关系表

遇到多层嵌套 JSON（如 {"orders":[{"id":1,"items":[{"sku":"A"}]}]}），在 Java 层解析既容易出错又难以维护。更高效的做法是在 SQL 层直接用 JSON_TABLE 展开为二维结果集：

SELECT jt.order_id, jt.sku
FROM my_table,
     JSON_TABLE(j, '$.orders[*]'
       COLUMNS (
         order_id NUMBER PATH '$.id',
         NESTED PATH '$.items[*]'
           COLUMNS (sku VARCHAR2(20) PATH '$.sku')
       )
     ) jt

如此，JDBC 只需按普通 ResultSet 处理，完全避免 JSON 解析的麻烦。

• JSON_TABLE 必须出现在 FROM 子句中，不能作为普通函数调用。
• 嵌套数组必须用 NESTED PATH，否则会触发笛卡尔积。
• 若某条 JSON 记录中 items 为空或缺失，加 NULL ON EMPTY 控制行为。

最后强调：JDBC 层面本身不具备 JSON 到 Java 对象的自动映射能力。Spring JDBC 的 BeanPropertyRowMapper、MyBatis 的默认 TypeHandler 均不识别 JSON 类型，需要自行编写 ResultSetExtractor 或注册自定义 TypeHandler。不要认为仅升级驱动就能完成 POJO 映射——二者是不同领域的问题。