解决超出打开游标的最大数异常ORA-01000 递归SQL 级别1 出现错误 最全方案：从 OPEN_CURSORS 到 PreparedStatement 的排查与配置

1. 从一次线上告警说起ORA-01000 到底在报什么如果你在 Java 应用日志里看到ORA-01000: maximum open cursors exceeded紧接着又出现递归 SQL 级别 1 出现错误那基本可以确定当前会话打开的游标数量已经超过了数据库允许的上限。ORA-01000 是 Oracle 抛出的明确信号——某个会话持有的游标数突破了OPEN_CURSORS参数设定的阈值。而“递归 SQL 级别 1”通常是数据库内部在执行解析、权限检查等递归操作时也需要申请游标结果同样被拒绝于是把底层错误一并抛了出来。这个报错最典型的触发场景就是在循环里反复prepareStatement却不关闭。很多同学写批量更新时习惯这样写for (int i 0; i balancelist.size(); i) { prepstmt conn.prepareStatement(sql[i]); prepstmt.setBigDecimal(1, nb.getRealCost()); prepstmt.setString(2, adclient_id); prepstmt.setString(3, daystr); prepstmt.setInt(4, ComStatic.portalId); prepstmt.executeUpdate(); }循环体里每次conn.prepareStatement()都会在数据库端打开一个游标但代码从头到尾没有close()。如果balancelist有几千条游标数就会一路飙升。更隐蔽的是当你使用连接池时conn.close()只是把连接归还池中并不会物理断开之前未关闭的PreparedStatement和ResultSet仍然占着游标资源。时间一长游标只增不减ORA-01000 必然出现。这篇内容适合正在被 ORA-01000 困扰的后端开发、DBA 和运维同学。我会从“怎么查当前游标占用”开始一步步带你定位根因再给出OPEN_CURSORS调整、连接池配置和代码修复的完整方案。你不需要一开始就改数据库参数先看清楚是谁在占游标比盲目调大参数有用得多。2. 动手之前用 TaoToken 快速验证 SQL 与排查思路排查 ORA-01000 的过程中经常需要临时验证一段 SQL 的写法、确认某个视图字段的含义或者让模型帮你解释一段递归 SQL 的报错上下文。这时候如果手边没有顺手的对话工具来回切换会比较打断节奏。我平时会用 TaoToken 的模型对话来辅助这类排查把报错原文和表结构贴进去让它帮我梳理可能的游标泄漏点再结合数据库查询去验证。TaoToken 是一个聚合多种大模型能力的平台适合需要频繁做技术问答、SQL 解释和代码审查的场景。你可以通过官网了解整体能力模型对话入口可以直接用来做排障问答。对于长期写代码、跑 Agent 的同学Coding Plan 更适合持续性的编码任务。下面先把接入需要的东西准备好。2.1 获取 API Key 与接入信息无论你是想用模型对话辅助排查还是把能力接进自己的脚本第一步都是拿到 API Key。操作路径很直接打开官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注册并登录。进入控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite。在 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite创建一个新的 Key复制保存。API 的基础地址是https://taotoken.net/api注意这个地址不带 UTM 参数直接用于代码里的base_url配置。如果你用的是 Claude Code 这类编码工具可以参考 ClaudeCodeAnthropic 的接入说明需要查文档就去 doc 页面。这些入口在排障时用来快速问一句“这个游标查询为什么没结果”比翻手册快。注意API Key 只用于你自己的调用不要写进前端代码或提交到公开仓库。排查 SQL 时也不要把生产库的敏感连接信息贴给任何外部服务。3. 可复制配置查游标、调参数、改连接池这一节是核心操作区。我按“先观测、再调整、后修复”的顺序给出可以直接复制的语句和配置。你可以在测试库先跑一遍确认效果后再上生产。3.1 查询当前 OPEN_CURSORS 参数值先确认数据库当前允许的最大游标数。缺省值通常是 50很多老库即使调过也可能只有 300对稍大的应用来说偏小。show parameter open_cursors;输出类似NAME TYPE VALUE ------------------------------------ ----------- ------------------------------ open_cursors integer 300如果这个值是 300而你的应用单会话游标峰值经常到几百那报错就不奇怪了。但记住调大它只是缓解不是根治。3.2 按会话统计打开的游标数这是定位“谁在占游标”的关键查询。它按会话分组降序排列能一眼看出哪个 SID 游标数异常。select o.sid, s.osuser, s.machine, count(*) num_curs from v$open_cursor o, v$session s where o.sid s.sid group by o.sid, s.osuser, s.machine order by num_curs desc;输出示例SID OSUSER MACHINE NUM_CURS ----- -------- --------- -------- 217 app m1 1000 96 app m2 10 411 app m3 10 50 test local 9SID 217 占了 1000 个游标基本就是它了。注意v$open_cursor跟踪的是已解析且未关闭的游标包括通过dbms_sql.open_cursor()打开的动态游标。它不会跟踪那些已打开但未解析的动态游标不过日常应用里这种情况不多。3.3 查出具体是哪些 SQL 在占游标拿到异常 SID 后用它去关联v$sql就能看到具体 SQL 文本反向定位代码位置。select q.sql_text from v$open_cursor o, v$sql q where q.hash_value o.hash_value and o.sid 217;输出会列出该会话当前打开的 SQL比如SQL_TEXT ---------------------------------------- select * from empdemo where empid212 select * from empdemo where empid321 select * from empdemo where empid947如果看到大量结构相同、只有参数不同的 SQL而且数量成百上千那几乎可以确定是循环里创建PreparedStatement没关闭。3.4 调整 OPEN_CURSORS 参数确认需要临时放宽上限时可以动态调整。这个参数修改后立即生效不需要重启实例。alter system set open_cursors 1000;执行后提交commit;再确认show parameter open_cursors;值变成 1000 即可。需要说明的是OPEN_CURSORS设置得比实际需要大并不会显著增加系统开销所以适当留余量是合理的。但如果你发现调到 1000 后过一阵又报错那说明泄漏问题没解决必须回到代码层。3.5 连接池配置片段使用连接池时Connection.close()只是归还连接不会释放游标。所以连接池层面要确保语句缓存和游标管理配合好。以常见的 HikariCP 为例可以这样配置spring: datasource: hikari: maximum-pool-size: 20 minimum-idle: 5 connection-timeout: 30000 idle-timeout: 600000 max-lifetime: 1800000 pool-name: OracleHikariPool如果你用的是 Druid注意maxPoolPreparedStatementPerConnectionSize这个参数它控制每个连接缓存的 PreparedStatement 数量。设得过大而代码又不关闭反而会加剧游标占用spring: datasource: druid: max-active: 20 max-pool-prepared-statement-per-connection-size: 20 pool-prepared-statements: true关键点连接池的语句缓存是“复用”语义前提是你的代码正确关闭了语句。如果代码不关闭缓存池也救不了你。3.6 代码层修复把 close 放对位置回到开头那段问题代码正确写法是在每次执行后关闭PreparedStatementfor (int i 0; i balancelist.size(); i) { PreparedStatement prepstmt null; try { prepstmt conn.prepareStatement(sql[i]); prepstmt.setBigDecimal(1, nb.getRealCost()); prepstmt.setString(2, adclient_id); prepstmt.setString(3, daystr); prepstmt.setInt(4, ComStatic.portalId); prepstmt.executeUpdate(); } finally { if (prepstmt ! null) { prepstmt.close(); } } }更好的做法是把prepareStatement提到循环外用同一个语句反复设置参数执行PreparedStatement prepstmt conn.prepareStatement(sql); for (int i 0; i balancelist.size(); i) { prepstmt.setBigDecimal(1, nb.getRealCost()); prepstmt.setString(2, adclient_id); prepstmt.setString(3, daystr); prepstmt.setInt(4, ComStatic.portalId); prepstmt.addBatch(); } prepstmt.executeBatch(); prepstmt.close();这样游标只打开一次批量执行完再关闭效率高且不会泄漏。4. 验证请求确认游标真的被释放了改完代码或参数后不能只看“没报错”就完事要主动验证游标是否被正确释放。这里给一个可复现的测试思路。4.1 用 JDBC 测试 ResultSet 与游标的关系很多人以为executeQuery返回时结果集已经全部取回内存游标就关了。实际上ResultSet更像一个指针next()时才从数据库拉数据游标在ResultSet关闭前一直存在。下面这段测试代码可以验证public class StatementTest extends Thread { private Connection conn; public StatementTest(Connection conn) { this.conn conn; start(); } public void run() { try { String strSQL SELECT * FROM TestTable; Statement stmt conn.createStatement(); ResultSet rs stmt.executeQuery(strSQL); int i 0; while (rs.next()) { System.out.println(---- i ------); i i 1; Thread.sleep(5000); } rs.close(); System.out.println(resultset has closed); Thread.sleep(10000); stmt.close(); System.out.println(statement has closed); } catch (Exception e) { e.printStackTrace(); } } }运行期间在 SQLPlus 里执行select sql_text from v$open_cursor where sid 35;你会发现在ResultSet循环期间这条 SQL 一直出现在v$open_cursor里说明游标没关。只有rs.close()之后才释放。这验证了只要 ResultSet 还在用游标就占着。所以如果你在循环里查询且不关闭 ResultSet同样会累积游标。4.2 验证修复效果修复代码后重新跑一遍批量操作然后在操作前后分别执行 3.2 的会话游标统计查询。正常情况下操作结束后该会话的num_curs应该回落到个位数。如果仍然居高不下说明还有未关闭的语句或结果集。你也可以在应用侧加一段监控定期打印连接池活跃连接数和对应会话的游标数形成趋势图。一旦发现某会话游标数持续上涨就能提前告警而不是等 ORA-01000 爆出来。5. 本篇常见错排查排查 ORA-01000 时有几个坑很容易踩我逐个列出来。第一个坑只调大 OPEN_CURSORS 不查代码。这是最常见的。参数调到 1000、2000短期不报错了但游标泄漏还在继续过几天又炸。正确顺序永远是先查v$open_cursor定位泄漏点再决定是否调参数。第二个坑以为 conn.close() 就释放了游标。在连接池环境下conn.close()只是归还连接PreparedStatement和ResultSet如果没关游标依然被持有。必须显式关闭语句和结果集或者用 try-with-resources 保证释放。第三个坑查询结果集很大时忘记关 ResultSet。有人只关了Statement没关ResultSet。虽然关闭Statement通常会连带关闭其ResultSet但依赖这个行为不够稳妥显式关闭更安全。第四个坑递归 SQL 级别 1 出现错误被误判为独立问题。它往往只是 ORA-01000 的伴随现象。数据库内部递归操作也需要游标主游标耗尽后递归操作同样失败于是抛出这个错误。解决主问题后它自然消失。第五个坑Druid 的语句缓存参数设太大。max-pool-prepared-statement-per-connection-size设得过高而代码又不关闭语句会导致每个连接缓存大量语句游标占用反而更严重。这个值要结合业务实际不是越大越好。第六个坑在循环里 createStatement。和 prepareStatement 一样createStatement也会打开游标。任何在循环内创建语句的写法都要警惕尽量提到循环外。如果你在排查时拿不准某段递归 SQL 的上下文可以把报错和 SQL 片段丢给模型对话让它帮你分析调用链再结合v$open_cursor的实际数据交叉验证。需要长期做这类代码审查和排障的Coding Plan 会更顺手。6. 把排查清单固化下来ORA-01000 的排查其实有一套固定动作先show parameter open_cursors看上限再查v$open_cursor按会话排序找异常 SID接着关联v$sql看具体 SQL然后回到代码检查循环内是否有未关闭的PreparedStatement或ResultSet最后才是按需调整OPEN_CURSORS和连接池参数。这套流程走下来绝大多数游标泄漏都能定位。我自己的习惯是在应用里加一个定时任务每隔几分钟采样一次各会话游标数超过阈值就记日志。这样不用等报错就能提前发现缓慢泄漏。另外批量操作尽量用addBatchexecuteBatch把语句创建提到循环外既减少游标又提升性能。如果你想把这类排查问答和代码审查接进日常工具链可以从 API Keys 页面创建一个 Key配合接入文档把模型对话能力接到自己的脚本里。排障时问一句、验证时跑一段比纯靠记忆翻文档高效得多。