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