应使用Clob.getCharacterStream()流式读取，避免getSubString()导致OOM；返回Reader需按固定缓冲区（如8192字符）分块读取，禁用readLine()和lines()，并确保连接与结果集保持打开状态。
Oracle CLOB字段读取时内存溢出怎么办
直接调用 clob.getsubstring(1, (int) clob.length()) 会把整个clob一次性加载进堆内存，几mb以上就容易触发 outofmemoryerror，尤其在高并发或字段平均超10mb的场景下几乎必现。
- 必须改用流式读取，绕过字符串中间转换
- 优先使用
Clob.getCharacterStream()（字符流），而非getAsciiStream()或getBinaryStream()，避免编码错乱（Oracle CLOB 默认是数据库字符集，如 AL32UTF8） - 注意：
getCharacterStream()返回的是Reader，别误当成InputStream去套BufferedInputStream
JDBC获取Clob对象后怎么安全转成String
不是所有CLOB都能无脑转String——长度可能超 Integer.MAX_VALUE（2GB限制），且部分JDBC驱动（如 ojdbc8）对超大CLOB的 length() 调用本身就会触发全量加载。
- 若确定长度可控（
），可用IOUtils.toString(clob.getCharacterStream(), StandardCharsets.UTF_8)（Apache Commons IO） - 若不确定大小，改用分块读取：
char[] buffer = new char[8192]+reader.read(buffer)循环拼接，同时加长度计数防无限循环 - 千万别用
clob.toString()—— 这是返回Clob对象的类名+哈希码，不是内容
PreparedStatement设置CLOB参数时为什么报“Stream has already been closed”
常见于用 connection.createClob() 创建临时CLOB后，往里写入数据，再 setClob，但写入流未关闭或连接提前复用。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 正确顺序：创建CLOB → 获取
Writer→ 写入 → 显式 close() Writer → 再ps.setClob(1, clob) - 更稳妥做法：用
ps.setCharacterStream(1, reader, length)直接传流，让JDBC驱动内部处理，避免手动管理Clob生命周期 - 使用 HikariCP 等连接池时，确保
setCharacterStream的Reader在executeUpdate()完成前不被关闭（流必须保持打开直到SQL执行完毕）
ojdbc驱动版本和CLOB流行为差异
ojdbc6 对 Clob.getCharacterStream() 返回的 Reader 不支持 mark/reset，且某些版本在 ResultSet 关闭后流立即失效；ojdbc8 改进明显，但默认仍启用缓存（oracle.jdbc.defaultLobPrefetchSize）。
- 生产环境建议用 ojdbc8（至少 19.3+），并配置连接参数：
oracle.jdbc.defaultLobPrefetchSize=0关闭预取，强制流式 - 测试时发现
Reader.ready()总返回 false？这是正常行为，Oracle CLOB流不支持 ready 检查，别依赖它判断是否可读 - 如果业务需要随机访问（如跳过前N个字符），CLOB本身不支持 seek，只能靠
skip()，但部分驱动实现效率极低，此时应考虑改用数据库侧 SUBSTR 函数分页查询
实际最易忽略的是：ResultSet 未关闭时，底层CLOB流句柄一直被持有，连接归还池后可能引发 LOB descriptor 泄漏——务必在 finally 块中先关 ResultSet，再关 Statement，且不要指望 try-with-resources 自动解决所有流生命周期问题。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
