Oracle 19c JSON列需用rs.getObject("col", String.class)读取，因驱动不自动转字符串；JSON_VALUE等是服务端函数，与JDBC无关，“OracleJsonValue驱动”不存在。
oracle 19c 的 json 列在 jdbc 中不能直接用 rs.getstring() 读取，必须显式指定 sqltype.json 才能拿到标准 json 字符串；json_value 等 sql 函数是服务端解析方案，与 jdbc 驱动无关，“oraclejsonvalue 驱动”并不存在——这是对 oracle jdbc 行为和 sql 函数的常见混淆。
rs.getString("col") 为什么在 Oracle 19c 上会报错或返回乱码
Oracle 19c 将原生 JSON 类型映射为独立 SQL 类型，JDBC 驱动（ojdbc8 ≥ 19.19）默认不将其自动转为字符串。调用 rs.getString("j") 会触发类型转换失败，抛出类似 SQLException: cannot convert to string 的异常；或者底层返回二进制 blob 内容（如 0x7B2261223A317D），解码后是乱码。
根本原因不是字符集问题，而是驱动未启用 JSON 类型协议支持。即使数据库字符集是 AL32UTF8，也不影响该行为。
-
rs.getObject("j", String.class)是唯一被 ojdbc8u3+ 原生支持的正确方式 -
rs.getObject("j")返回的是oracle.sql.json.OracleJsonStructure，不能直接toString()或强转 - 低版本驱动（如 ojdbc7）根本不识别
JSON类型，会报ORA-00902: invalid datatype
SQLType.JSON 必须显式传入，不能靠驱动自动推断
JDBC 规范要求：当列类型为扩展 SQL 类型（如 JSON、XML）时，必须通过带 SQLType 参数的 getObject(int, Class) 或 getObject(String, Class) 显式声明目标类型，否则驱动 fallback 到通用类型处理逻辑，大概率失败。
示例中正确的写法：
立即学习“Java免费学习笔记（深入）”；
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 映射问题。
