fetchSize是JDBC中控制每次从数据库拉取行数的关键参数，用于分批获取结果集以减少内存占用和网络往返；必须在执行SQL前通过Statement或PreparedStatement的setFetchSize()设置，推荐值100–500，Integer.MIN_VALUE可启用流式模式。
在 Java 中通过 JDBC 读取大数据量结果集时，fetchSize 是一个关键参数，它控制每次从数据库网络传输中拉取多少行数据到 JVM 内存。合理设置 fetchSize 能显著减少内存占用、避免 OOM，并提升流式读取的吞吐效率——但它的实际效果取决于数据库驱动支持和执行模式（如是否启用游标）。
fetchSize 的作用与底层机制
fetchSize 并不改变 SQL 查询本身，而是影响 JDBC 驱动如何分批获取 ResultSet 数据：
- 默认值通常为 0 或 1，意味着“全量拉取”或“逐行拉取”，对大数据集极易引发内存溢出；
- 设为正整数（如 1000）后，驱动会在需要时按批次从数据库服务器获取指定行数（类似隐式游标）；
- 注意：该设置仅对 Statement 和 PreparedStatement 生效，对 CallableStatement 效果有限；
- MySQL 驱动需配合
useCursorFetch=true参数 +setFetchSize(n)才真正启用服务器端游标；PostgreSQL 默认支持；Oracle 需开启隐式游标（自动生效）。
正确设置 fetchSize 的代码示例
必须在 执行查询前 设置，执行后调用无效：
Connection conn = dataSource.getConnection();
PreparedStatement ps = conn.prepareStatement("SELECT * FROM large_table WHERE ...");
ps.setFetchSize(5000); // 关键：执行前设置
ResultSet rs = ps.executeQuery(); // 此时驱动才可能启用分批获取
若使用 Spring JdbcTemplate，可通过 new JdbcTemplate(dataSource).query(..., new RowCallbackHandler() { ... }) 并在 PreparedStatementSetter 中设置 fetchSize；MyBatis 则在 Mapper XML 的 <select></select> 标签中添加 fetchSize="5000" 属性。
javascript-typescript-typescript-scaffold
下载
你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型
立即学习“Java免费学习笔记（深入）”；
常见误区与注意事项
fetchSize 不是银弹，用错反而拖慢性能：
- 不要盲目设过大：如设为 10 万，单次网络包过大或驱动缓冲区溢出，可能触发重传或连接中断；建议从 1000–5000 测试起步；
- ORDER BY + LIMIT 场景慎用：数据库仍需先排序全部数据，fetchSize 只影响返回阶段，无法降低服务端计算压力；
- 事务隔离级别影响可见性：长事务中分批读取，可能因其他事务提交导致中间结果不一致（幻读），需结合业务判断是否可接受；
- 某些驱动忽略该值：如 H2、Derby 等嵌入式数据库不支持，调用 setFetchSize 无实际效果，应查阅对应驱动文档确认兼容性。
配合流式处理的最佳实践
单纯设 fetchSize 不够，还需避免一次性加载全部结果：
- 始终使用
while (rs.next())逐行处理，而非rs.getRows()（该方法多数驱动未实现）； - 处理完一行立即释放资源引用（如清空临时对象、触发 GC 友好操作）；
- 关闭 ResultSet/Statement/Connection 顺序不能颠倒，推荐 try-with-resources；
- 对写入类场景（如导出 CSV），直接边读边写，避免缓存中间 List。
