1. 从 9i 升到 11g 后 SQL 突然报错先搞清楚版本差异在哪如果你手上有一套跑了七八年的 Oracle 9i 老系统最近要迁到 11g大概率会遇到这种场面同一段 SQL9i 里跑得好好的换到 11g 直接抛错或者结果集悄悄变了。这不是你写错了而是 11g 在语法校验、GROUP BY 语义、游标行为和全表扫描策略上都做了收紧。这篇就围绕oracle sql group by 全表扫描 ORA-01002这几个关键词把升级迁移里最容易踩的几类写法拆开讲清楚每个都给你可复制的对照示例和排查步骤。先说清楚这篇适合谁正在做 9i 到 11g或更高版本数据库迁移的 DBA、后端开发以及需要排查历史 SQL 兼容性问题的同学。核心要解决的问题有三个——哪些 SQL 写法在 11g 会直接报错、ORA-01002 到底怎么复现和定位、以及怎么用执行计划和版本参数逐条验证。我试过在测试库上把这几类语句一条条跑一遍下面按「问题现象 → 复现步骤 → 排查方法」的顺序展开你可以直接照着在测试环境验证。需要提前说明的是11g 的很多「报错」其实是把 9i 时代依赖未定义行为的写法给禁掉了。9i 允许你写一些语义模糊的 SQL数据库帮你「猜」一个结果11g 则要求语义明确猜不出来就报错。理解这一点后面的排查思路就顺了。2. 迁移前的前置准备环境、参数与工具链在动手改 SQL 之前先把验证环境搭好否则你改一条测一条效率极低。这一节讲清楚需要准备什么以及怎么用 TaoToken 这类工具辅助你快速验证模型对 SQL 语义的理解比如让它帮你解释某段 SQL 在 11g 下的行为差异。2.1 数据库侧的准备你需要一个 11g 的测试实例版本建议 11.2.0.3 及以上因为很多兼容性行为在这个版本已经稳定。关键参数先确认几个参数名9i 常见值11g 建议关注点optimizer_modeRULE / CHOOSE11g 默认 ALL_ROWSCHOOSE 已废弃compatible9.2.0迁移时先设成 11.2.0 观察行为cursor_sharingEXACT保持 EXACT避免绑定变量窥探干扰db_cache_size较小影响全表扫描是否走 direct path read你可以用下面这条语句确认当前实例的兼容性设置show parameter compatible; show parameter optimizer_mode; select * from v$version;如果compatible还停留在 9.2.0很多 11g 的新行为不会触发排查时会误判。建议在测试库上先把它调到 11.2.0再复现问题。2.2 用 TaoToken 辅助理解 SQL 语义差异迁移过程中经常遇到「这段 SQL 到底在 9i 里是什么意思」的问题。这时候可以用 TaoToken 的模型对话能力把 SQL 贴进去让它解释执行语义尤其是 GROUP BY 和游标相关的模糊写法。接入方式很简单Base URL 用https://taotoken.net/apiKey 在控制台生成。如果你要长期做迁移排查建议直接开 Coding Plan把常用的 SQL 对照脚本和排查清单沉淀下来。模型对话入口在 https://taotoken.net/api 控制台和 API Keys 在 https://taotoken.net/console 和 https://taotoken.net/api-keys 。文档在 https://taotoken.net/doc 。2.3 准备对照测试表后面几类问题都需要复现先把测试表建好create table tmp(id number, flag number); insert into tmp values(1,1); commit; create table t1(c varchar2(2)); insert into t1 values(a); commit; create table exam_decision_main(seq number, clientno number); insert into exam_decision_main values(1, 100); commit;这几张表后面会反复用到建一次就行。3. 三类典型 SQL 写法对照GROUP BY、INSERT 自引用、游标回滚这一节是核心把 9i 能跑、11g 报错的三类写法逐条对照。每条都给你 9i 的原始写法和 11g 的修正写法以及可复制的验证脚本。3.1 GROUP BY 单独使用9i 自动排序11g 不保证顺序9i 里GROUP BY会隐式排序所以很多人写 SQL 时省略了ORDER BY依赖 GROUP BY 的排序结果。11g 不再保证这个顺序结果集顺序可能变化如果业务代码依赖顺序就会出问题。更严重的是「仅单行 GROUP BY 时查询结果可包含其他列名」这种写法。看这个例子-- 9i 可以执行11g 报 ORA-00979 select a, flag from (select 1 a, flag from tmp) group by flag;在 9i 里因为flag只有一行数据库「猜」出a的值是1所以能返回。11g 严格执行 GROUP BY 规则SELECT 列表里非聚合列必须出现在 GROUP BY 中否则报ORA-00979: not a GROUP BY expression。修正写法有两种看你的业务需求-- 方案一把 a 也放进 GROUP BY select a, flag from (select 1 a, flag from tmp) group by a, flag; -- 方案二用聚合函数包住 a select max(a) a, flag from (select 1 a, flag from tmp) group by flag;排查方法在 9i 库里搜所有「GROUP BY 但 SELECT 列表有非聚合列」的 SQL。可以用这个查询从v$sql里捞select sql_text from v$sql where upper(sql_text) like %GROUP BY% and upper(sql_text) not like %ORDER BY%;捞出来逐条人工确认重点看 SELECT 列表和 GROUP BY 列表是否一致。3.2 INSERT 时查询表本身9i 容忍11g 报错第二类写法是在 INSERT 的 VALUES 子句里查询同一张表-- 9i 不报错11g 报 ORA-00904 或语义错误 insert into exam_decision_main a (seq) values ( (select decode(max(seq), null, 1, max(seq) 1) seq from exam_decision_main where clientno a.clientno) );9i 对这种自引用 INSERT 比较宽容11g 则要求语义明确a.clientno这种别名引用在 VALUES 子句里解析会出问题。修正写法把子查询改成先算好再插入或者用 MERGE-- 方案一先查后插 declare v_seq number; v_clientno number : 100; begin select decode(max(seq), null, 1, max(seq) 1) into v_seq from exam_decision_main where clientno v_clientno; insert into exam_decision_main(seq, clientno) values(v_seq, v_clientno); commit; end; / -- 方案二用 MERGE merge into exam_decision_main a using (select 100 clientno from dual) b on (a.clientno b.clientno) when not matched then insert (seq, clientno) values (1, b.clientno) when matched then update set a.seq a.seq 1;排查方法搜所有 INSERT 语句里带子查询且子查询引用了目标表的 SQL。3.3 游标前有未提交 DML 循环内 ROLLBACKORA-01002 复现这是最典型的一类也是 ORA-01002 最常见的触发场景。看复现脚本set serveroutput on declare cursor cur is select c from t1; v varchar2(2); begin insert into t1 values(1); open cur; loop fetch cur into v; exit when cur%notfound; rollback; end loop; close cur; end; /在 9i9.2.0.8上这段不报错在 10g10.2.0.4和 11g11.2.0.3.2上会报ORA-01002: fetch out of sequence。原因是游标打开后循环里执行了 ROLLBACK导致游标依赖的一致性读快照失效再次 FETCH 就报错。这属于 Bug 13256185官方在 10.2 之后的行为变更。注意一个细节用FOR ... LOOP不报错用显式OPEN/FETCH/CLOSE才报错。因为 FOR LOOP 内部对游标状态做了额外处理。修正写法把 ROLLBACK 移出游标循环或者用 FOR LOOP-- 方案一ROLLBACK 移到循环外 declare cursor cur is select c from t1; v varchar2(2); begin insert into t1 values(1); open cur; loop fetch cur into v; exit when cur%notfound; end loop; close cur; rollback; end; / -- 方案二改用 FOR LOOP begin insert into t1 values(1); for r in (select c from t1) loop null; end loop; rollback; end; /排查方法搜所有 PL/SQL 里同时出现OPEN、FETCH、ROLLBACK的存储过程。可以用这个查询select name, type from dba_source where upper(text) like %ROLLBACK% and name in ( select name from dba_source where upper(text) like %FETCH% );4. 验证请求与成功结果执行计划 版本参数逐条确认改完 SQL 不能只看「不报错了」还要确认结果集和执行计划符合预期。这一节给你一套验证流程。4.1 用执行计划确认全表扫描行为9i 和 11g 的全表扫描策略不同9i 全表扫描的数据会缓存在 DB CACHE 中11g 则通过 DIRECT PATH READ 进入 PGA不缓存。这意味着同一个表如果被多次全表扫描11g 的效率可能低于 9i。用EXPLAIN PLAN看执行计划explain plan for select * from exam_decision_main where clientno 100; select * from table(dbms_xplan.display);重点看TABLE ACCESS FULL这一行以及Note部分有没有dynamic sampling之类的提示。如果发现某张表被频繁全表扫描考虑加索引create index idx_edm_clientno on exam_decision_main(clientno);加完再跑一次执行计划确认变成INDEX RANGE SCAN。4.2 用版本参数确认兼容性行为前面提到的compatible参数直接决定了很多行为是否触发。验证方法select name, value from v$parameter where name compatible;如果值是 9.2.0很多 11g 的新校验不会生效你测出来的「不报错」是假象。测试库上建议设成 11.2.0alter system set compatible 11.2.0 scope spfile; -- 需要重启实例4.3 用 TaoToken 模型对话验证 SQL 语义改完的 SQL 如果不确定语义对不对可以贴到 TaoToken 模型对话里让它解释执行逻辑尤其是 MERGE 和游标改写这类容易出错的场景。入口在 https://taotoken.net/api 选模型对话即可。5. 本篇常见报错排查ORA-01002、ORA-00979、401 与 local proxy failed这一节把迁移过程中最常遇到的报错集中列出来对照真实错误信息给排查方向。5.1 ORA-01002: fetch out of sequence这是本篇的核心报错。触发条件游标打开后在 FETCH 之间执行了 COMMIT 或 ROLLBACK。排查步骤第一步确认报错的存储过程里有没有OPEN ... FETCH ... ROLLBACK/COMMIT的组合。第二步看是不是用了显式游标而不是 FOR LOOP。第三步确认数据库版本9.2.0.8 不报10.2.0.4 及以上报。修正就是前面 3.3 节给的两种方案。如果业务逻辑必须在中途 ROLLBACK考虑把游标数据先批量取到集合变量里再处理。5.2 ORA-00979: not a GROUP BY expression触发条件SELECT 列表里有非聚合列没出现在 GROUP BY 中。排查方法把报错的 SQL 拿出来逐列对照 GROUP BY 列表。修正用 3.1 节的两种方案。5.3 401 与 local proxy failed如果你在用工具链比如 Cline、Codex 这类辅助排查可能会遇到 401 或 local proxy failed。401 通常是 API Key 没配或过期去 https://taotoken.net/api-keys 重新生成。local proxy failed 一般是本地代理配置问题检查 Base URL 是否写成了https://taotoken.net/api注意不要多加路径。5.4 reading choices 报错这个报错通常出现在调用模型接口时返回结构解析失败。检查请求体里的 model 参数是否拼写正确以及返回的 JSON 结构是否符合预期。如果用的是 Coding Plan确认套餐还在有效期内。5.5 OAuth 相关报错如果你在接入 Claude Code 或类似工具时遇到 OAuth 报错检查回调地址和 token 是否匹配。Claude Code 的接入文档在 https://taotoken.net/doc 里面有完整的配置步骤。6. 迁移排查清单与长期编码方案把前面的内容收拢成一份可执行的检查清单你迁移时按这个顺序走一遍基本能覆盖大部分兼容性问题。第一步确认测试库compatible参数已设为 11.2.0optimizer_mode为 ALL_ROWS。第二步从v$sql和dba_source里捞出所有 GROUP BY、INSERT 自引用、游标含 ROLLBACK 的 SQL。第三步逐条在 11g 测试库执行记录报错。第四步按本篇给的修正方案改写改写后用执行计划确认性能。第五步回归测试业务逻辑重点验证结果集顺序和数值。如果你要长期做这类迁移和 SQL 审查工作建议开 TaoToken 的 Coding Plan把排查脚本、对照示例、修正模板都沉淀成可复用的资产。Coding Plan 入口在 https://taotoken.net/api 控制台在 https://taotoken.net/console 。模型对话适合临时验证单条 SQLCoding Plan 适合把整套迁移流程固化下来。最后提醒一个容易忽略的点11g 对ORDER BY在 EXISTS 子查询里的处理也和 9i 不同。9i 和 10g 里EXISTS 子查询里的 ORDER BY 是无效的11g 支持但会忽略。如果你有类似写法迁移时顺手清理掉避免误导后续维护的人。