Oracle 12.1.0.2+ 支持原生 JSON 构造函数，应直接用 JSON_OBJECT 和 JSON_ARRAYAGG 生成字符串/CLOB，Java 层调用 getString() 或 getClob() 获取，避免 getObject() 导致 ClassCastException。
Oracle 12c+ 直接用 JSON_OBJECT 和 JSON_ARRAYAGG 构造结果
oracle 12.1.0.2 起原生支持 json 构造函数，不需要 java 拼字符串或额外依赖。关键不是“java 怎么转”，而是“让 oracle 直接吐 json 字符串”，java 层只做 resultset.getstring() 即可。
常见错误是 Java 里用 ResultSet.getObject() 拿 oracle.sql.STRUCT 或 oracle.sql.ARRAY，结果抛 ClassCastException 或乱码 —— Oracle 的 JSON 函数返回的是 VARCHAR2 或 CLOB，不是自定义类型。
-
JSON_OBJECT(*)把整行转为单个 JSON 对象（字段名自动映射） -
JSON_ARRAYAGG(JSON_OBJECT(*))把多行聚合成一个 JSON 数组 - 如果字段含中文或特殊字符，确保数据库字符集是 AL32UTF8，且 JDBC URL 加
?useUnicode=true&characterEncoding=UTF-8 - 大结果集慎用
JSON_ARRAYAGG：它在服务端内存里拼完整字符串，可能 OOM；超 4000 字符优先选CLOB返回，Java 用getClob()+getSubString()流式读
SELECT JSON_ARRAYAGG(
JSON_OBJECT('id' VALUE t.id, 'name' VALUE t.name, 'ctime' VALUE t.create_time)
) AS json_result
FROM user_info t WHERE t.status = 'A';
JDBC 获取时别用 getObject，用 getString 或 getClob
即使 SQL 里写了 JSON_OBJECT，JDBC 驱动默认仍可能把返回类型识别为 OTHER，getObject() 会尝试转 STRUCT，失败率极高。
正确做法是明确按字符串或 CLOB 取值，不依赖类型推断：
- 小结果（确定 rs.getString("json_result")
- 大结果或不确定长度：用
rs.getClob("json_result")，再调clob.getSubString(1, (int) clob.length()) - 别设
setFetchSize试图“流式 JSON”——JSON_ARRAYAGG是聚合函数，必须等全量数据算完才返回一行，fetch size 无效
Java 层不需要额外 JSON 库处理返回值
有人习惯拿到字符串后用 Jackson 的 ObjectMapper.readTree() 再转一次，纯属多余。Oracle 返回的就是合法 JSON 字符串，前端可直接 JSON.parse()，Java 后端若只需透传，连校验都可跳过。
立即学习“Java免费学习笔记（深入）”；
唯一要干预的场景是字段名需驼峰化、或需过滤空值——但这些应在 SQL 层做（用 JSON_OBJECT(KEY 'userName' VALUE t.user_name ABSENT ON NULL)），而非 Java 拆了重拼。
-
ABSENT ON NULL比 Java 判空更高效，避免 null 字段出现在 JSON 中 - 别在 Java 里用
String.replace()修字段名，SQL 层用KEY 'xxx' VALUE yyy显式指定 - 如果业务要求动态字段列表，SQL 动态拼接比 Java 组装 JSON 更可靠（避免引号转义漏逃）
Oracle 12c 以下版本只能靠 Java 拼，但风险极高
低于 12.1.0.2 的 Oracle 不支持原生 JSON 函数，有人用 WM_CONCAT 或自定义 PL/SQL 包模拟，但极易出错：字段含双引号、换行、反斜杠时 JSON 格式直接破坏，前端 JSON.parse() 报错。
真要兼容老版本，推荐方案是升级驱动 + 数据库，次选是 Java 侧用 Jackson 的 ObjectWriter.writeValueAsString() 从 ResultSet 构建对象再序列化——至少有标准转义保障。
注意：老版本下 ResultSetMetaData 获取列名可能大小写混乱（尤其用了双引号建表），需统一转小写或按实际建表名硬编码 key，否则 JSON 字段名不一致。
