Java如何使用Oracle JDBC驱动实现查询结果的流式拉取

Oracle JDBC流式查询必须显式关闭自动提交，否则fetchSize失效且可能报ORA-01002；需用PreparedStatement、TYPE_FORWARD_ONLY和CONCUR_READ_ONLY，并注意驱动与Oracle版本兼容性。

Oracle JDBC驱动流式查询必须显式关闭自动提交

oracle的流式拉取（streaming fetch）依赖于游标保持打开状态，而默认的connection在自动提交（auto-commit）模式下，每执行一条语句都会隐式提交并可能提前关闭游标。不关掉它，fetchsize设再大也拿不到流式效果，甚至直接报ora-01002: fetch out of sequence。

实操建议：

调用connection.setAutoCommit(false)，且后续无需手动commit()（流式读取不涉及写操作）
若业务逻辑中该连接还用于其他DML操作，请确保流式查询独占一个专用Connection
使用完务必调用connection.close()——Oracle服务端游标资源不会自动释放，不关连接会导致游标泄漏

fetchSize设多少才真正触发服务器端分批拉取

Oracle JDBC驱动对fetchSize的处理是“建议型”的：它只在满足特定条件时才会启用服务器端游标分页（即真正流式），否则仍是一次性把结果集全拉到客户端内存。

关键条件有三个，缺一不可：

使用PreparedStatement（不能是Statement）
ResultSet类型为ResultSet.TYPE_FORWARD_ONLY（默认值，但显式指定更稳妥）
ResultSet并发模式为ResultSet.CONCUR_READ_ONLY（同样默认，但建议显式声明）

示例设置：

PreparedStatement ps = connection.prepareStatement(
    "SELECT id, name, content FROM large_table WHERE status = ?",
    ResultSet.TYPE_FORWARD_ONLY,
    ResultSet.CONCUR_READ_ONLY
);
ps.setFetchSize(1000); // 这个值才可能生效
ResultSet rs = ps.executeQuery();

ResultSet.next()才是真正的“拉取动作”，不是executeQuery()

很多人误以为调用executeQuery()时数据就已开始分批传输，其实不然。Oracle JDBC直到第一次调用rs.next()才会向数据库发起首次fetch请求；后续每次next()都可能触发一次网络往返（取决于fetchSize和剩余行数）。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

这意味着：

如果循环中对每行做耗时处理（如IO、HTTP调用），next()的延迟会暴露出来，需留意整体吞吐瓶颈位置
不能在rs.next()前就关闭Connection或PreparedStatement，否则抛SQLException: Closed Connection
调用rs.close()会立即发送close cursor指令给Oracle，未读完的行将被丢弃（无异常）

注意Oracle版本与ojdbc驱动的兼容性陷阱

Oracle 12c R1（12.1.0.x）起引入了隐式结果集（implicit statement cache）和新的fetch协议优化，但老版本ojdbc驱动（如ojdbc6）无法识别，仍走传统路径，导致fetchSize失效或行为异常。

推荐组合：

Oracle 12cR2+ 或 19c/21c → 使用ojdbc8.jar（对应JDK 8+）
Oracle 11gR2 → 必须用ojdbc6.jar，且确认数据库参数cursor_sharing不能设为FORCE（否则预编译被改写，破坏fetchSize语义）
无论哪个版本，避免混用不同大版本的ojdbc jar（例如用ojdbc8连11g库虽能连上，但流式fetch可能静默退化）

最容易被忽略的一点：Oracle服务端参数array_size（SQL*Plus里的/SET ARRAYSIZE）不影响JDBC驱动行为，JDBC完全由setFetchSize()和驱动内部协议控制，别被DBA经验误导。