Java利用OracleJsonValue驱动高效解析JSON_B数据

Oracle 19c 的原生 JSON 列，在 JDBC 里不能直接用 rs.getString() 获取——必须显式调用 rs.getObject("col", String.class) 才能正确读取。网上流传的“OracleJsonValue 驱动”其实是个常见误区：JSON_VALUE 是数据库服务端的内置函数，与 JDBC 驱动毫无关联。简单来说，这是两种完全不同的机制，很多人把 SQL 解析能力和驱动行为混为一谈了。

为什么 rs.getString("col") 在 Oracle 19c 上会抛出异常或返回乱码

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 映射——那完全是两回事。