尧图网页设计 
1. 从一次 ORA-01000 报警说起open_cursor 到底卡在哪Java 应用跑着跑着突然抛ORA-01000: maximum open cursors exceeded这个报错在测试环境里特别常见尤其是批量任务、定时跑批、循环查库的场景。它的本质不是数据库挂了而是当前会话打开的游标数量超过了open_cursors参数上限。游标在 Oracle 里对应的是服务端为每条 SQL 分配的一块私有内存区域Statement和ResultSet没关游标就不会释放累积到阈值直接报错。很多人第一反应是去调大open_cursors比如从 300 改到 2000。这招能续命但只是把泄漏点往后推跑得久一点照样爆。真正要做的是把「谁在开游标、开了多少、哪条 SQL 没关」这三件事查清楚。这篇就按这个思路走先用 SQL 定位当前会话的游标数量和正在执行的语句再从连接池配置和代码层两条线索切入最后把诊断脚本的调用凭证统一收口到 TaoToken 的通道里避免诊断脚本散落各处、Key 到处硬编码。适合谁看正在被 ORA-01000 折磨的 Java 后端、需要排查连接池游标泄漏的 DBA、以及想把诊断工具链统一管理的同学。下面所有 SQL 和配置都可以直接复制到测试环境跑。2. 前置准备用 TaoToken 统一管理诊断脚本的调用凭证排查游标泄漏时通常会写一堆诊断脚本有的查v$mystat有的查v$open_cursor有的跑压测复现。这些脚本如果各自硬编码数据库连接串、各自申请模型调用的 Key管理起来会很乱。我的做法是把诊断脚本里需要调用外部模型能力比如让模型帮忙分析 SQL 文本、生成排查建议的凭证统一走 TaoToken 的 API 通道。TaoToken 在这里的角色是统一入口一个 Key 管多个模型的调用诊断脚本不用为每个模型单独配一套凭证。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 注意 API 地址不带 UTM 参数。具体操作路径先到控制台创建 Key地址是 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 。如果你只是想让模型帮忙读一段 SQL 文本、给排查方向用模型对话页就够了 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 。如果是长期跑编码类诊断脚本、要接 Agent那更适合用 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。注意诊断脚本里不要明文写 Key用环境变量注入。TaoToken 的 Key 只是调用凭证数据库连接串还是走你自己的配置中心。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite ClaudeCode 相关的接入说明在 https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite 。把凭证收口之后后面所有诊断脚本调用模型分析时只认一个环境变量换 Key 只改一处。3. 可复制配置连接池参数与 open_cursor 查询 SQL3.1 先确认数据库侧的 open_cursors 上限在动手改代码之前先看当前上限是多少。用 DBA 账号执行show parameter open_cursors;输出里value就是上限。测试环境常见是 300生产可能 1000 到 2000。这个值决定了你有多大的缓冲空间但不解决泄漏。3.2 统计当前会话打开的游标数量这是定位问题的第一步。v$mystat里opened cursors current这个统计项就是当前会话打开的游标数select a.value, a.sid from v$mystat a, v$statname b where a.statistic# b.statistic# and b.name opened cursors current;a.value是打开数量a.sid是当前会话 ID。把这个 sid 记下来下一步要用。如果这个值在循环里持续上涨、不回落基本可以确认有泄漏。3.3 查出该会话正在执行的 SQL 文本拿到 sid 之后去v$open_cursor里查这个会话打开了哪些游标select sql_text from v$open_cursor where sid sid;把上一步的 sid 填进去。结果里会列出该会话当前打开的所有 SQL 文本。重点看那些重复出现、或者明显是循环里执行的查询。比如一个select ... from t where id ?出现几十次那大概率是循环里创建了 Statement 没关。3.4 连接池侧的关键参数连接池配置不当会放大游标泄漏。以 HikariCP 为例几个参数要盯紧spring: datasource: hikari: maximum-pool-size: 20 minimum-idle: 5 connection-timeout: 30000 idle-timeout: 600000 max-lifetime: 1800000 leak-detection-threshold: 20000leak-detection-threshold是关键设成 20000 毫秒20 秒连接借出超过这个时间没归还HikariCP 会打警告日志能帮你抓到没关连接的代码位置。max-lifetime要小于数据库侧的连接空闲超时避免拿到已被服务端断开的连接。如果用 Druid对应的是spring: datasource: druid: max-active: 20 initial-size: 5 max-wait: 30000 remove-abandoned: true remove-abandoned-timeout: 180 log-abandoned: trueremove-abandoned开启后连接借出超过remove-abandoned-timeout秒没归还会被强制回收并打日志。这个日志就是泄漏点的直接线索。3.5 用 TaoToken 通道跑诊断脚本的调用示例诊断脚本里如果需要调用模型分析 SQL 文本用环境变量拿 Key请求走 TaoToken 的 APIexport TAOTOKEN_API_KEY你的Key export TAOTOKEN_BASE_URLhttps://taotoken.net/apiimport os import requests api_key os.environ[TAOTOKEN_API_KEY] base_url os.environ[TAOTOKEN_BASE_URL] resp requests.post( f{base_url}/v1/chat/completions, headers{Authorization: fBearer {api_key}}, json{ model: claude-sonnet-4-20250514, messages: [ {role: user, content: 分析这段SQL是否有游标泄漏风险select * from t where id ?} ] }, timeout30 ) print(resp.json())这样诊断脚本的凭证只从环境变量来换 Key 不用改代码。4. 验证请求复现游标泄漏并逐条关闭资源4.1 写一个会泄漏的最小复现程序先故意写一段不关 ResultSet 和 Statement 的代码在测试环境复现 ORA-01000public void leakCursors(Connection conn) throws Exception { for (int i 0; i 500; i) { Statement stmt conn.createStatement(); ResultSet rs stmt.executeQuery(select * from dual); // 故意不关 rs 和 stmt } }跑这段循环几百次之后再执行 3.2 的查询会看到opened cursors current的值一路涨到接近open_cursors上限然后抛 ORA-01000。4.2 改成正确关闭的版本用 try-with-resources 保证 ResultSet 和 Statement 一定关闭public void safeQuery(Connection conn) throws Exception { String sql select * from dual; try (Statement stmt conn.createStatement(); ResultSet rs stmt.executeQuery(sql)) { while (rs.next()) { // 处理结果 } } }如果项目还在用老式 try-catch-finally那 finally 里必须按 ResultSet、Statement、Connection 的顺序逐层关闭且每个 close 都要单独 try-catch避免前一个关闭失败导致后面不执行Statement stmt null; ResultSet rs null; try { stmt conn.createStatement(); rs stmt.executeQuery(select * from dual); while (rs.next()) { } } finally { if (rs ! null) { try { rs.close(); } catch (SQLException e) { log.warn(close rs, e); } } if (stmt ! null) { try { stmt.close(); } catch (SQLException e) { log.warn(close stmt, e); } } }4.3 验证关闭效果改完之后重新跑压测再执行 3.2 的查询。正常情况下opened cursors current会在每次查询结束后回落到一个稳定值不会持续上涨。如果还是涨说明还有别的泄漏点回到 3.3 查v$open_cursor看哪条 SQL 还在重复出现。4.4 用连接池日志交叉验证开启 HikariCP 的leak-detection-threshold后如果还有连接没归还日志里会出现类似Connection leak detection triggered for conn0, stack trace follows java.lang.Exception: Apparent connection leak detected at com.example.YourDao.query(YourDao.java:42)这个堆栈直接指向没关连接的代码行比翻代码快得多。5. 本篇常见错排查5.1 查 v$open_cursor 返回空v$open_cursor需要相应权限普通业务账号可能查不到。用 DBA 账号或者给业务账号授select on v_$open_cursor。另外 sid 填错也会返回空确认 3.2 里拿到的 sid 是当前会话的。5.2 open_cursors 调大了还是报错调大只是提高上限泄漏速度不变的话只是报错来得晚一点。必须回到代码层找没关的 ResultSet 和 Statement。重点查循环体、异常分支、提前 return 的路径这些地方最容易漏关。5.3 连接池 remove-abandoned 没生效Druid 的remove-abandoned依赖remove-abandoned-timeout单位是秒设太小会误杀正常长查询设太大抓不到泄漏。建议测试环境设 180 秒配合log-abandoned: true看日志。HikariCP 对应的是leak-detection-threshold单位毫秒设 20000 比较合适。5.4 诊断脚本的 Key 报 401先确认环境变量TAOTOKEN_API_KEY有没有正确导出再确认请求头是Authorization: Bearer key。如果用的是 Coding Plan 或 ClaudeCode 接入注意 base_url 和模型名要跟文档一致接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。模型对话页可以直接验证 Key 是否可用 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 。5.5 游标数在连接归还后不降Oracle 的游标是会话级的连接归还到池里但会话没断游标可能还挂着。如果连接池的max-lifetime设得太大连接长期不重建游标就一直累积。把max-lifetime设成小于数据库侧的空闲超时让连接定期重建能缓解这个问题。但根治还是靠代码层正确关闭。6. 把诊断链路收口到统一通道排查 ORA-01000 这件事拆开看就是三步用 SQL 定位游标数量和 SQL 文本用连接池参数和日志抓泄漏点用代码层 try-with-resources 或 finally 逐条关闭资源。这三步里诊断脚本会越来越多凭证管理容易失控。我的做法是把所有需要调用模型能力的诊断脚本统一走 TaoToken 的 API 通道Key 从环境变量注入换 Key 只改一处。控制台建 Key 在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。长期跑编码类诊断、要接 Agent 的用 Coding Plan 更合适 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入细节看文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。最后留一个我踩过的坑v$open_cursor里看到的 SQL 文本可能被截断长 SQL 看不全。这时候可以结合v$sql按sql_id查完整文本或者直接在代码里搜 SQL 片段。定位到具体方法之后优先检查循环和异常分支这两个地方是游标泄漏的重灾区。 open_cursor 诊断实战：用 TaoToken 统一通道排查 ORA-01000 与未关闭 statement
1. 从一次 ORA-01000 报警说起open_cursor 到底卡在哪Java 应用跑着跑着突然抛ORA-01000: maximum open cursors exceeded这个报错在测试环境里特别常见尤其是批量任务、定时跑批、循环查库的场景。它的本质不是数据库挂了而是当前会话打开的游标数量超过了open_cursors参数上限。游标在 Oracle 里对应的是服务端为每条 SQL 分配的一块私有内存区域Statement和ResultSet没关游标就不会释放累积到阈值直接报错。很多人第一反应是去调大open_cursors比如从 300 改到 2000。这招能续命但只是把泄漏点往后推跑得久一点照样爆。真正要做的是把「谁在开游标、开了多少、哪条 SQL 没关」这三件事查清楚。这篇就按这个思路走先用 SQL 定位当前会话的游标数量和正在执行的语句再从连接池配置和代码层两条线索切入最后把诊断脚本的调用凭证统一收口到 TaoToken 的通道里避免诊断脚本散落各处、Key 到处硬编码。适合谁看正在被 ORA-01000 折磨的 Java 后端、需要排查连接池游标泄漏的 DBA、以及想把诊断工具链统一管理的同学。下面所有 SQL 和配置都可以直接复制到测试环境跑。2. 前置准备用 TaoToken 统一管理诊断脚本的调用凭证排查游标泄漏时通常会写一堆诊断脚本有的查v$mystat有的查v$open_cursor有的跑压测复现。这些脚本如果各自硬编码数据库连接串、各自申请模型调用的 Key管理起来会很乱。我的做法是把诊断脚本里需要调用外部模型能力比如让模型帮忙分析 SQL 文本、生成排查建议的凭证统一走 TaoToken 的 API 通道。TaoToken 在这里的角色是统一入口一个 Key 管多个模型的调用诊断脚本不用为每个模型单独配一套凭证。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 注意 API 地址不带 UTM 参数。具体操作路径先到控制台创建 Key地址是 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 。如果你只是想让模型帮忙读一段 SQL 文本、给排查方向用模型对话页就够了 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 。如果是长期跑编码类诊断脚本、要接 Agent那更适合用 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。注意诊断脚本里不要明文写 Key用环境变量注入。TaoToken 的 Key 只是调用凭证数据库连接串还是走你自己的配置中心。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite ClaudeCode 相关的接入说明在 https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite 。把凭证收口之后后面所有诊断脚本调用模型分析时只认一个环境变量换 Key 只改一处。3. 可复制配置连接池参数与 open_cursor 查询 SQL3.1 先确认数据库侧的 open_cursors 上限在动手改代码之前先看当前上限是多少。用 DBA 账号执行show parameter open_cursors;输出里value就是上限。测试环境常见是 300生产可能 1000 到 2000。这个值决定了你有多大的缓冲空间但不解决泄漏。3.2 统计当前会话打开的游标数量这是定位问题的第一步。v$mystat里opened cursors current这个统计项就是当前会话打开的游标数select a.value, a.sid from v$mystat a, v$statname b where a.statistic# b.statistic# and b.name opened cursors current;a.value是打开数量a.sid是当前会话 ID。把这个 sid 记下来下一步要用。如果这个值在循环里持续上涨、不回落基本可以确认有泄漏。3.3 查出该会话正在执行的 SQL 文本拿到 sid 之后去v$open_cursor里查这个会话打开了哪些游标select sql_text from v$open_cursor where sid sid;把上一步的 sid 填进去。结果里会列出该会话当前打开的所有 SQL 文本。重点看那些重复出现、或者明显是循环里执行的查询。比如一个select ... from t where id ?出现几十次那大概率是循环里创建了 Statement 没关。3.4 连接池侧的关键参数连接池配置不当会放大游标泄漏。以 HikariCP 为例几个参数要盯紧spring: datasource: hikari: maximum-pool-size: 20 minimum-idle: 5 connection-timeout: 30000 idle-timeout: 600000 max-lifetime: 1800000 leak-detection-threshold: 20000leak-detection-threshold是关键设成 20000 毫秒20 秒连接借出超过这个时间没归还HikariCP 会打警告日志能帮你抓到没关连接的代码位置。max-lifetime要小于数据库侧的连接空闲超时避免拿到已被服务端断开的连接。如果用 Druid对应的是spring: datasource: druid: max-active: 20 initial-size: 5 max-wait: 30000 remove-abandoned: true remove-abandoned-timeout: 180 log-abandoned: trueremove-abandoned开启后连接借出超过remove-abandoned-timeout秒没归还会被强制回收并打日志。这个日志就是泄漏点的直接线索。3.5 用 TaoToken 通道跑诊断脚本的调用示例诊断脚本里如果需要调用模型分析 SQL 文本用环境变量拿 Key请求走 TaoToken 的 APIexport TAOTOKEN_API_KEY你的Key export TAOTOKEN_BASE_URLhttps://taotoken.net/apiimport os import requests api_key os.environ[TAOTOKEN_API_KEY] base_url os.environ[TAOTOKEN_BASE_URL] resp requests.post( f{base_url}/v1/chat/completions, headers{Authorization: fBearer {api_key}}, json{ model: claude-sonnet-4-20250514, messages: [ {role: user, content: 分析这段SQL是否有游标泄漏风险select * from t where id ?} ] }, timeout30 ) print(resp.json())这样诊断脚本的凭证只从环境变量来换 Key 不用改代码。4. 验证请求复现游标泄漏并逐条关闭资源4.1 写一个会泄漏的最小复现程序先故意写一段不关 ResultSet 和 Statement 的代码在测试环境复现 ORA-01000public void leakCursors(Connection conn) throws Exception { for (int i 0; i 500; i) { Statement stmt conn.createStatement(); ResultSet rs stmt.executeQuery(select * from dual); // 故意不关 rs 和 stmt } }跑这段循环几百次之后再执行 3.2 的查询会看到opened cursors current的值一路涨到接近open_cursors上限然后抛 ORA-01000。4.2 改成正确关闭的版本用 try-with-resources 保证 ResultSet 和 Statement 一定关闭public void safeQuery(Connection conn) throws Exception { String sql select * from dual; try (Statement stmt conn.createStatement(); ResultSet rs stmt.executeQuery(sql)) { while (rs.next()) { // 处理结果 } } }如果项目还在用老式 try-catch-finally那 finally 里必须按 ResultSet、Statement、Connection 的顺序逐层关闭且每个 close 都要单独 try-catch避免前一个关闭失败导致后面不执行Statement stmt null; ResultSet rs null; try { stmt conn.createStatement(); rs stmt.executeQuery(select * from dual); while (rs.next()) { } } finally { if (rs ! null) { try { rs.close(); } catch (SQLException e) { log.warn(close rs, e); } } if (stmt ! null) { try { stmt.close(); } catch (SQLException e) { log.warn(close stmt, e); } } }4.3 验证关闭效果改完之后重新跑压测再执行 3.2 的查询。正常情况下opened cursors current会在每次查询结束后回落到一个稳定值不会持续上涨。如果还是涨说明还有别的泄漏点回到 3.3 查v$open_cursor看哪条 SQL 还在重复出现。4.4 用连接池日志交叉验证开启 HikariCP 的leak-detection-threshold后如果还有连接没归还日志里会出现类似Connection leak detection triggered for conn0, stack trace follows java.lang.Exception: Apparent connection leak detected at com.example.YourDao.query(YourDao.java:42)这个堆栈直接指向没关连接的代码行比翻代码快得多。5. 本篇常见错排查5.1 查 v$open_cursor 返回空v$open_cursor需要相应权限普通业务账号可能查不到。用 DBA 账号或者给业务账号授select on v_$open_cursor。另外 sid 填错也会返回空确认 3.2 里拿到的 sid 是当前会话的。5.2 open_cursors 调大了还是报错调大只是提高上限泄漏速度不变的话只是报错来得晚一点。必须回到代码层找没关的 ResultSet 和 Statement。重点查循环体、异常分支、提前 return 的路径这些地方最容易漏关。5.3 连接池 remove-abandoned 没生效Druid 的remove-abandoned依赖remove-abandoned-timeout单位是秒设太小会误杀正常长查询设太大抓不到泄漏。建议测试环境设 180 秒配合log-abandoned: true看日志。HikariCP 对应的是leak-detection-threshold单位毫秒设 20000 比较合适。5.4 诊断脚本的 Key 报 401先确认环境变量TAOTOKEN_API_KEY有没有正确导出再确认请求头是Authorization: Bearer key。如果用的是 Coding Plan 或 ClaudeCode 接入注意 base_url 和模型名要跟文档一致接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。模型对话页可以直接验证 Key 是否可用 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 。5.5 游标数在连接归还后不降Oracle 的游标是会话级的连接归还到池里但会话没断游标可能还挂着。如果连接池的max-lifetime设得太大连接长期不重建游标就一直累积。把max-lifetime设成小于数据库侧的空闲超时让连接定期重建能缓解这个问题。但根治还是靠代码层正确关闭。6. 把诊断链路收口到统一通道排查 ORA-01000 这件事拆开看就是三步用 SQL 定位游标数量和 SQL 文本用连接池参数和日志抓泄漏点用代码层 try-with-resources 或 finally 逐条关闭资源。这三步里诊断脚本会越来越多凭证管理容易失控。我的做法是把所有需要调用模型能力的诊断脚本统一走 TaoToken 的 API 通道Key 从环境变量注入换 Key 只改一处。控制台建 Key 在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。长期跑编码类诊断、要接 Agent 的用 Coding Plan 更合适 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入细节看文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。最后留一个我踩过的坑v$open_cursor里看到的 SQL 文本可能被截断长 SQL 看不全。这时候可以结合v$sql按sql_id查完整文本或者直接在代码里搜 SQL 片段。定位到具体方法之后优先检查循环和异常分支这两个地方是游标泄漏的重灾区。