ORA-00600 KGL-heap-size-exceeded 排查，把 Codex 的 Base URL 改到 TaoToken-育师

1. ORA-00600 KGL-heap-size-exceeded 到底卡在哪

ORA-00600 [KGL-heap-size-exceeded] 是 Oracle 数据库里比较典型的一类内部错误，字面意思是 KGL（Kernel Generic Library）堆内存超限。KGL 堆主要存放游标、库缓存对象、SQL 元数据这些东西，它跟 shared pool 是绑在一起的。一旦 KGL 堆被撑爆，数据库会大量生成 core 文件，业务 TPS 直接掉到接近 0，等故障时段过去又自己恢复，然后高峰期再反复出现。

这个场景适合谁看：手上有一套 Oracle 12.2 环境、alert 日志里出现过 KGL-heap-size-exceeded、shared pool 等待严重、SQL version count 高到离谱的 DBA 或运维同学。核心检索词就是 ORA-00600、KGL-heap-size-exceeded、cursor 不共享、BIND_EQUIV_FAILURE。

我先把问题链路捋一遍。故障时间点看 AWR，shared pool 相关等待非常重，KGL 占用 9G 以上，shared pool 统计占用到 90% 左右。报错 SQL 的 version count 达到 900+，而_cursor_obsolete_threshold当时是 1024，也就是说游标版本还没到淘汰阈值，但已经堆了一大片。用V$SQL_BIND_CAPTURE和v$sql_shared_cursor查 cursor 为什么不共享，发现BIND_EQUIV_FAILURE为 Y，绑定变量等价性判断失败，导致同一个 SQL 反复生成子游标，KGL 堆被这些子游标撑满。

常规动作是加 shared pool，从 20G 调到 40G，故障确实不再出现，但那条 SQL 的 version count 依旧很高。再把_cursor_obsolete_threshold从 1024 降到 50，version count 才缓解。查 MOS 2610645.1，发现BIND_EQUIV_FAILURE可能是 12.2 的 bug，官方给了 Patch 28794230 和一组_optimizer_use_feedback、_optimizer_adaptive_cursor_sharing、_optimizer_extended_cursor_sharing_rel的 workaround。

问题在于：这些线索散落在 AWR、V$ 视图、MOS 文档和一堆隐藏参数里，人工对照很费时间。我想把 Codex 接到 TaoToken 的统一 API 通道上，让它帮我整理排查思路、对照 MOS 方案取舍，但 Codex 本身不连 Oracle，数据库侧的 SQL、AWR、alter system 还是我在本地 SQL*Plus 里执行，只把粘贴出来的结果交给 Codex 分析。

2. 把 Codex 的 Base URL 改到 TaoToken

这一步是前置准备。TaoToken 只提供 Key 和 Base URL，让 Codex 走统一 API 通道，不碰你的数据库。先打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 注册账号，然后在控制台创建 API Key。创建 Key 的入口在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite ，登录后点新建，复制那串 Key 存好。

Base URL 填https://taotoken.net/api，注意两点：不要加/v1，也不要用官网首页地址。很多人习惯性写成https://taotoken.net/api/v1，结果请求 404，这个坑我见得太多了。Codex 的配置一般放在~/.codex/config.toml或者环境变量里，下面给一份可复制的配置。

# ~/.codex/config.toml model = "gpt-5-codex" model_provider = "taotoken" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api" env_key = "TAOTOKEN_API_KEY" wire_api = "chat"

如果你更习惯用环境变量，也可以这样：

export TAOTOKEN_API_KEY="sk-你从TaoToken控制台复制的Key" export OPENAI_BASE_URL="https://taotoken.net/api"

配置完保存，别急着让它分析 ORA-00600，先发一条普通请求确认通道是通的。这一步很关键，通道没通后面全是白费。

3. 可复制配置与验证请求

3.1 先确认 Codex 能正常对话

在终端里跑一条最简单的请求，确认 Key 和 Base URL 都生效：

codex exec "用一句话说明 Oracle shared pool 的作用"

如果返回正常文本，说明 Codex 已经通过 TaoToken 兼容通道跑起来了。如果报 401，检查 Key 有没有复制全；如果报 404，八成是 Base URL 多写了/v1。想直接在网页里验证模型是否可用，可以打开模型对话页 https://taotoken.net/model-chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite ，发一条测试消息，能回就说明账号和 Key 都没问题。

3.2 数据库侧采集，Codex 侧分析

记住一个原则：Codex 不连 Oracle。下面这些 SQL 你在本地 SQL*Plus 执行，把结果粘贴给 Codex。

先看故障时间点的 shared pool 和 KGL 占用：

-- 查看 shared pool 各子池占用 SELECT pool, name, bytes/1024/1024 AS mb FROM v$sgastat WHERE pool = 'shared pool' AND name IN ('free memory', 'miscellaneous') ORDER BY bytes DESC; -- 查看 KGL 相关堆占用 SELECT ksmchcls, SUM(ksmchsiz)/1024/1024 AS mb FROM x$ksmsp WHERE ksmchcls LIKE 'KGL%' GROUP BY ksmchcls ORDER BY mb DESC;

再看那条 version count 900+ 的 SQL，确认 cursor 不共享的原因：

SELECT c.sql_id, c.SQL_TYPE_MISMATCH, c.BIND_EQUIV_FAILURE, b.POSITION, b.DATATYPE_STRING, b.LAST_CAPTURED FROM V$SQL_BIND_CAPTURE b, v$sql_shared_cursor c WHERE c.CHILD_ADDRESS = b.CHILD_ADDRESS AND c.SQL_ID = '9pvt6prqzddvy';

把这两段结果、AWR 里 shared pool 等待的片段、以及BIND_EQUIV_FAILURE=Y的行一起粘贴给 Codex，让它逐条对照原文排查步骤和 MOS 2610645.1 的方案取舍。你可以这样给它下指令：

下面是我从 Oracle 12.2 环境采集的 V$SQL_BIND_CAPTURE、v$sql_shared_cursor 和 AWR 片段。 现象：ORA-00600 [KGL-heap-size-exceeded]，KGL 占用 9G+，shared pool 20G 调到 40G 后故障消失但 version count 仍高， _cursor_obsolete_threshold 从 1024 降到 50 后缓解，BIND_EQUIV_FAILURE=Y。 请帮我：1) 按可能性排序 cursor 不共享的原因；2) 对照 MOS 2610645.1 的 Patch 28794230 和 _optimizer_use_feedback 等 workaround 给出取舍建议； 3) 列出还需要在本地 SQL*Plus 补采哪些视图。不要假设你能连数据库。

3.3 参数调整的本地执行

下面这些 alter system 仍然在本地 SQL*Plus 执行，Codex 只帮你判断该不该做、顺序怎么排：

-- 调整 shared pool（需根据实际 SGA 评估） ALTER SYSTEM SET shared_pool_size = 40G SCOPE = SPFILE; -- 降低游标淘汰阈值，缓解 version count ALTER SYSTEM SET "_cursor_obsolete_threshold" = 50 SCOPE = SPFILE; -- MOS 2610645.1 给出的 workaround，先评估再执行 ALTER SYSTEM SET "_optimizer_use_feedback" = FALSE SCOPE = SPFILE; ALTER SYSTEM SET "_optimizer_adaptive_cursor_sharing" = FALSE SCOPE = SPFILE; ALTER SYSTEM SET "_optimizer_extended_cursor_sharing_rel" = NONE SCOPE = SPFILE;

隐藏参数改动前一定要在测试库验证，生产库改完要重启才生效的记得安排窗口。Codex 能帮你把这几条参数的影响面、回退方式列清楚，但执行权在你手里。

4. 验证请求与成功结果

通道验证分两层。第一层是 Codex 本身可用，前面那条codex exec返回正常文本就算过。第二层是让它真的能处理 ORA-00600 的排查素材。

我实测下来，把v$sql_shared_cursor的完整输出和 AWR 的 Top 10 等待事件粘进去，Codex 能给出这样的结构化输出：先按BIND_EQUIV_FAILURE、SQL_TYPE_MISMATCH、ROLL_INVALID_MISMATCH等字段逐项判断，再对照 MOS 2610645.1 说明 Patch 28794230 和 workaround 的适用条件，最后列出还需要补采的视图，比如v$sql_shared_cursor里其他标志位、v$librarycache的 reload 情况。

成功的结果长这样：你拿到一份排查清单，知道先看哪个字段、哪个参数改动风险高、哪个 workaround 可以先在测试库试。数据库侧的 alter system 还是你自己敲，Codex 不碰生产库。

如果你后面要长期做这类排查，甚至想把 Codex 挂到日常运维脚本里做辅助分析，可以看看 Coding Plan https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite ，适合需要持续调用、批量整理排查记录的场景。

5. 本篇常见错排查

5.1 Base URL 写错导致 404

最常见的错误是把 Base URL 写成https://taotoken.net/api/v1或者直接写官网首页。正确值是https://taotoken.net/api，不加/v1。报 404 先查这里。

5.2 Key 没生效报 401

检查环境变量名和配置文件里的env_key是否一致。如果你在 config.toml 里写env_key = "TAOTOKEN_API_KEY"，那环境变量就必须叫这个名字，大小写敏感。Key 复制时前后带空格也会导致 401。

5.3 让 Codex 直接连 Oracle

Codex 不连 Oracle，也不该给它数据库连接串。所有 V$ 视图、AWR、alter system 都在本地 SQL*Plus 执行，只把文本结果粘贴过去。试图让它直连生产库既做不到也不安全。

5.4 隐藏参数改完没重启

_cursor_obsolete_threshold、_optimizer_use_feedback这些用SCOPE = SPFILE改的，必须重启实例才生效。只改 spfile 不重启，查询v$parameter看到的还是旧值，会误以为没生效。

5.5 把 shared pool 调大就当解决了

shared pool 从 20G 调到 40G 只是缓解了 KGL 堆被撑爆的速度，version count 依旧高说明 cursor 不共享的根因还在。BIND_EQUIV_FAILURE=Y对应的 12.2 bug 和 workaround 才是要对照处理的部分，别停在加内存这一步。

5.6 忽略 core 文件占满 /oracle 目录

故障时大量 cdmp core 文件会把 /oracle 目录撑满，进而引发更多问题。排查时先清理 core 文件释放空间，再去看 AWR 和 V$ 视图，否则连日志都写不进去。

6. 把 Codex 配通到 TaoToken 之后

从 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 拿到 Key，把 Codex 的 Base URL 填成https://taotoken.net/api，通道就通了。之后你可以在本地 SQL*Plus 采集V$SQL_BIND_CAPTURE、v$sql_shared_cursor、BIND_EQUIV_FAILURE和 KGL 堆超限的线索，粘贴给 Codex，让它帮你整理 ORA-00600 与 cursor 共享问题的排查思路、对照 MOS 2610645.1 的方案取舍。

接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，配置细节和参数说明都在里面。控制台 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite 可以管理 Key 和用量。数据库侧的 alter system 和 Patch 决策始终由你在本地执行，Codex 只做分析辅助，这条边界别越过去。