如何在Java中使用Oracle的JSON函数_将结果集直接以JSON字符串返回前端

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 字段名不一致。