Oracle 例外（异常）处理实战：用 TaoToken 统一 Key 调试 PL/SQL 报错配置

1. Oracle 例外处理到底在解决什么问题写 PL/SQL 的人迟早会碰到这样的场景存储过程跑得好好的某天上游传进来一个空值或者SELECT INTO突然返回两行程序直接抛出一串ORA-01422、ORA-06502之类的报错日志里只有一行红字根本不知道是哪条业务分支炸的。Oracle 例外异常处理就是专门用来兜住这些运行时错误的机制它让你能把「出错」变成「可控的分支」而不是让整个事务莫名其妙地回滚。Oracle 的例外大致分三类预定义例外有名字的系统错误比如NO_DATA_FOUND、TOO_MANY_ROWS、ZERO_DIVIDE、非预定义例外系统有错误码但没给你起名需要自己PRAGMA EXCEPTION_INIT绑定、自定义例外跟 Oracle 错误无关纯粹是业务逻辑上你认为「这算异常」用RAISE手动抛出。这三类的捕获写法不一样排查思路也不一样很多人卡就卡在「不知道当前这个报错属于哪一类」。这篇面向的是正在写或维护 PL/SQL 的开发者尤其是那种「报错能复现、但定位不到具体例外分支」的情况。我会用一个可复制的 TaoToken 统一 Key 配置骨架把调试环境先搭顺再演示一次完整的异常复现与验证动作让你能照着把自己的例外分支一条条跑通。核心检索词就三个Oracle、例外、异常处理。2. 用 TaoToken 统一 Key 把调试环境先理顺调试 PL/SQL 例外最烦的不是写代码而是环境零散本地一个连接串、测试库一个、有时候还要连同事的库看数据Key 和地址到处复制改一次错一次。我习惯用 TaoToken 做统一入口把模型对话、编码辅助、API 调用收敛到一套 Key 上这样排查例外时注意力能集中在 SQL 本身而不是在配置里翻来翻去。TaoToken 在这里的角色是「统一 Key 的接入层」你申请一个 Key配置好 base_url就能在支持 OpenAI 兼容协议的工具里直接调用包括做 PL/SQL 代码补全、报错解释、例外分支生成的场景。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/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 。拿到形如sk-xxxx的字符串后别急着写进代码先放进环境变量后面所有配置都引用变量避免 Key 泄漏到版本库里。注意Key 只用于你自己的调试环境不要硬编码进存储过程或提交到 Git。PL/SQL 里如果需要调用外部 HTTP 服务也要走服务端封装不要把 Key 写进数据库对象。如果你用的是 Claude Code 这类编码工具来辅助写 PL/SQL可以走 Anthropic 兼容入口https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-code-anthropicutm_campaignrewrite 它和统一 Key 是同一套账号体系配置一次就能复用。3. 可复制的配置骨架与 settings.json 片段先给一份最小可用的配置骨架。核心就三样base_url、api_key、model。base_url 固定填https://taotoken.net/apiapi_key 从环境变量读model 按你实际用的填。下面这份settings.json片段可以直接抄注意把env里的变量名对上你系统里实际设置的。{ env: { TAOTOKEN_API_KEY: sk-你的Key, TAOTOKEN_BASE_URL: https://taotoken.net/api }, models: { default: gpt-4o-mini, coding: claude-3-5-sonnet }, request: { timeout: 60, max_retries: 2 } }如果你不想把 Key 写进 json用环境变量注入更稳妥。Linux/macOS 下export TAOTOKEN_API_KEYsk-你的Key export TAOTOKEN_BASE_URLhttps://taotoken.net/apiWindows PowerShell$env:TAOTOKEN_API_KEYsk-你的Key $env:TAOTOKEN_BASE_URLhttps://taotoken.net/api配置好之后先用一个最简单的请求验证连通性别等写了一大段 PL/SQL 才发现 Key 是错的。用 curl 测一下curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [{role: user, content: 用一句话解释 Oracle 的 NO_DATA_FOUND 例外}] }返回里能看到choices字段和一段解释就说明 Key 和地址都通了。这一步过了再进 PL/SQL 的例外调试。4. 异常复现与验证从 ORA 报错到自定义例外捕获现在进入正题。我准备了一张简化的员工表emp1字段有empno和sal然后写一个存储过程故意制造三种例外场景逐个验证捕获分支。先建表和数据CREATE TABLE emp1 ( empno NUMBER(4) PRIMARY KEY, sal NUMBER(7,2) ); INSERT INTO emp1 VALUES (7369, 800); INSERT INTO emp1 VALUES (7499, 1600); COMMIT;4.1 预定义例外NO_DATA_FOUND 与 TOO_MANY_ROWS第一个过程演示SELECT INTO查不到数据时触发NO_DATA_FOUNDCREATE OR REPLACE PROCEDURE ex_no_data(p_empno NUMBER) IS v_sal emp1.sal%TYPE; BEGIN SELECT sal INTO v_sal FROM emp1 WHERE empno p_empno; DBMS_OUTPUT.PUT_LINE(薪资: || v_sal); EXCEPTION WHEN NO_DATA_FOUND THEN DBMS_OUTPUT.PUT_LINE(没有找到员工: || p_empno); WHEN TOO_MANY_ROWS THEN DBMS_OUTPUT.PUT_LINE(返回了多行请检查条件); END; /调用一个不存在的工号SET SERVEROUTPUT ON; EXEC ex_no_data(9999);输出是没有找到员工: 9999说明NO_DATA_FOUND分支被正确捕获。如果你把WHERE条件去掉就会触发TOO_MANY_ROWS输出第二行提示。这两个是最常见的预定义例外写SELECT INTO时几乎必须带上。4.2 非预定义例外用 PRAGMA EXCEPTION_INIT 绑定错误码有些 Oracle 错误没有预定义名字比如ORA-02291违反外键约束。你得先声明一个例外名再用PRAGMA EXCEPTION_INIT把错误码绑上去CREATE OR REPLACE PROCEDURE ex_fk(p_empno NUMBER) IS e_fk_violation EXCEPTION; PRAGMA EXCEPTION_INIT(e_fk_violation, -2291); BEGIN INSERT INTO emp1 VALUES (p_empno, 100); EXCEPTION WHEN e_fk_violation THEN DBMS_OUTPUT.PUT_LINE(外键约束冲突工号: || p_empno); WHEN DUP_VAL_ON_INDEX THEN DBMS_OUTPUT.PUT_LINE(主键重复工号: || p_empno); END; /调用EXEC ex_fk(7369);会命中DUP_VAL_ON_INDEX因为 7369 已存在。这里DUP_VAL_ON_INDEX是预定义例外而e_fk_violation是非预定义两者可以写在同一个EXCEPTION块里Oracle 会按顺序匹配。4.3 自定义例外业务逻辑上的「异常」自定义例外跟 Oracle 错误无关是你自己认为「这算异常」。比如更新员工薪资时如果SQL%NOTFOUND为真说明没更新到任何行业务上要报错CREATE OR REPLACE PROCEDURE ex_test(spNo NUMBER) IS myex EXCEPTION; BEGIN UPDATE emp1 SET sal sal 100 WHERE empno spNo; IF SQL%NOTFOUND THEN RAISE myex; END IF; DBMS_OUTPUT.PUT_LINE(更新成功工号: || spNo); EXCEPTION WHEN myex THEN DBMS_OUTPUT.PUT_LINE(没有做任何更新工号: || spNo); END; /调用EXEC ex_test(8888);输出没有做任何更新工号: 8888调用EXEC ex_test(7369);输出更新成功工号: 7369。这就是自定义例外的完整闭环声明、RAISE、捕获。4.4 用 TaoToken 辅助定位报错当你拿到一个陌生的ORA-xxxxx报错不确定它属于哪一类例外时可以直接把报错贴给模型对话入口https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 让它告诉你这个错误码对应的预定义例外名、是否需要PRAGMA EXCEPTION_INIT、以及推荐的捕获写法。实测下来这一步能省掉大量翻文档的时间尤其是那些不常见的错误码。如果你在长期维护一套 PL/SQL 代码库需要反复生成例外分支、补全EXCEPTION块可以考虑 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 把编码辅助的调用额度固定下来不用每次临时配。5. 本篇常见错误排查ORA-06550 / PLS-00201标识符必须声明。多半是PRAGMA EXCEPTION_INIT写在了BEGIN之后或者例外名拼写不一致。声明区必须在IS和BEGIN之间。捕获不到自定义例外。检查RAISE的例外名和WHEN后面的名字是否完全一致Oracle 对大小写不敏感但拼写必须一致。另外WHEN OTHERS如果写在前面会吞掉后面的具体分支顺序要从具体到宽泛。DBMS_OUTPUT 没输出。忘了SET SERVEROUTPUT ON或者客户端缓冲区太小。在 SQL*Plus 里先执行SET SERVEROUTPUT ON SIZE UNLIMITED。Key 配置报 401。先确认Authorization头是Bearer sk-xxx格式中间有空格再确认 base_url 是https://taotoken.net/api而不是带/v1的完整路径具体看工具要求有的工具需要补/v1。用第 3 节的 curl 命令先测通再进代码。例外被 WHEN OTHERS 静默吞掉。这是最常见的坑。WHEN OTHERS里至少写一句DBMS_OUTPUT.PUT_LINE(SQLERRM)或写日志表否则出错你什么都看不到。生产环境建议把SQLCODE和SQLERRM一起记录。非预定义例外的错误码符号搞反。PRAGMA EXCEPTION_INIT里的错误码要带负号比如-2291写成正数会绑定失败。6. 把例外分支一条条跑通例外处理这件事光看文档记不住必须自己造数据、触发、看输出。我的建议是每写一个存储过程至少准备三个调用用例——正常路径、预定义例外路径、自定义例外路径跑一遍确认每个WHEN分支都能命中。上面那三个过程ex_no_data、ex_fk、ex_test就是最小验证集你可以直接拿去改。调试环境用 TaoToken 统一 Key 收敛之后换库、换工具都不用重新配 Key注意力能真正放在 SQL 逻辑上。需要新建 Key 或管理额度时控制台在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到配置问题先翻文档再排查比盲目试错快得多。