PRAGMA EXCEPTION_INIT必须在声明区(DECLARE与BEGIN之间)定义,异常名需先用EXCEPTION声明,格式为PRAGMA EXCEPTION_INIT(异常名, -五位错误码),如-02291;错误码须带负号且五位补零,不可跨块复用,捕获后需显式ROLLBACK处理事务。

PRAGMA EXCEPTION_INIT 必须在声明区完成,不能放在 BEGIN 之后,否则会报 PLS-00103 错误。
EXCEPTION_INIT 的声明位置和语法要求
它不是运行时语句,而是编译期指令(pragma),所以只能出现在 PL/SQL 块的声明部分(DECLARE 和 BEGIN 之间)。
- 异常变量名必须先用
EXCEPTION显式声明 -
PRAGMA EXCEPTION_INIT紧跟其后,格式严格为:PRAGMA EXCEPTION_INIT(异常名, 负的错误码) - 错误码必须带负号,且是五位数字(如
-01400,不能写成1400或-1400—— 后者虽常被接受,但 Oracle 官方文档明确要求五位补零格式) - 同一异常名不能重复绑定,否则报
PLS-00112
常见错误码与对应场景的绑定示例
不是所有错误都有预定义名称,比如外键约束失败(ORA-02291)、死锁(ORA-00060)、空值插入非空列(ORA-01400)都需要手动绑定。
- 外键引用不存在:用
PRAGMA EXCEPTION_INIT(e_fk_violation, -02291) - 死锁:必须写
-00060(不是-60),否则不触发 - 唯一索引冲突:
PRAGMA EXCEPTION_INIT(e_dup_key, -00001) - 空值插入 NOT NULL 列:
PRAGMA EXCEPTION_INIT(e_null_insert, -01400)
注意:-20999 到 -20000 是用户自定义错误保留段,EXCEPTION_INIT 不适用于它们 —— 那些要用 RAISE_APPLICATION_ERROR。
异常作用域和子程序中的复用
用 PRAGMA EXCEPTION_INIT 绑定的异常名只在当前块(或子程序)内有效,无法跨块继承。
- 如果存储过程里调用了另一个函数,且两者都要捕获
ORA-00060,那两个地方都得各自声明e_deadlock EXCEPTION并各自写一遍PRAGMA EXCEPTION_INIT - 不能在包规范(package spec)里声明异常并指望包体(body)直接使用 —— 包体仍需独立绑定
- 匿名块中定义的异常,退出后即销毁,无法被后续块访问
捕获后必须显式处理事务状态
Oracle 在抛出某些错误(如死锁、主键冲突)时会自动回滚当前语句,但不会自动回滚整个事务;如果你没在 EXCEPTION 块里写 ROLLBACK,后续语句可能在脏数据上继续执行。
- 对死锁、约束违例这类可恢复错误,仅
DBMS_OUTPUT.PUT_LINE记日志是危险的 —— 必须ROLLBACK,再决定是否RAISE或RAISE_APPLICATION_ERROR -
WHEN OTHERS THEN里不要漏掉SQLCODE和SQLERRM,否则难以定位真实错误源 - 绑定后的异常名一旦在
WHEN子句中使用,就只会捕获对应错误码,不会“降级”匹配其他错误
最容易被忽略的是:错误码格式不一致导致绑定失效(比如用了 -60 却以为能捕获死锁),以及在子程序里忘了重新绑定就直接 WHEN e_deadlock —— 这时实际走的是 WHEN OTHERS 分支。











