能用,但必须满足三个硬性条件:错误码是负整数、在-10000000到-1(含)之间且不能是-1403;异常名必须先声明;pragma必须紧跟在异常声明之后。
能用,但必须满足三个硬性条件:错误码是负整数、在 -10000000 到 -1(含)之间、且不能是 -1403;异常名必须先声明;pragma 必须紧跟在异常声明之后。
PRAGMA EXCEPTION_INIT 的参数合法性校验
Oracle 对 PRAGMA EXCEPTION_INIT 的第二个参数(错误码)极其严格。传入 1、0、-1403 或 -10000001 都会直接编译失败,报 PLS-00701: illegal ORACLE error number。
- 合法范围:仅限
-100(代表 NO_DATA_FOUND)或任意-1至-9999999之间的负整数,-1403被明确排除 -
-100是特例,它对应NO_DATA_FOUND,但系统已预定义,一般无需再映射 - 常见业务错误码如
-2292(外键约束)、-1(违反唯一约束)、-60(死锁)都合法 - 注意:错误码必须带负号,写成
60或'-60'(字符串)都会报错
声明顺序与作用域限制
PRAGMA EXCEPTION_INIT 不是运行时语句,而是编译指令,必须紧贴在对应异常变量声明的下一行,且只能在该声明的作用域内生效。
- 异常变量必须用
EXCEPTION类型声明,例如:deadlock_err EXCEPTION; - 紧接着必须写:
PRAGMA EXCEPTION_INIT(deadlock_err, -60);—— 中间不能插入其他声明或语句 - 如果在包头声明异常和 PRAGMA,在包体里无法复用;每个 PL/SQL 块需独立声明
- 不能在匿名块外(比如视图、函数体外)使用;也不能在 SQL*Plus 的全局上下文中定义
捕获非预定义异常的实际写法
用 PRAGMA EXCEPTION_INIT 的核心价值,是把模糊的 WHEN OTHERS 替换为精准的异常分支,避免掩盖真实问题。
- 典型场景:想单独处理死锁,而不是混在
OTHERS里 —— 先声明deadlock_err EXCEPTION;,再PRAGMA EXCEPTION_INIT(deadlock_err, -60); - 在
EXCEPTION块中直接写:WHEN deadlock_err THEN ...,里面可重试、记录日志或返回特定码 - 注意:
SQLCODE和SQLERRM在该分支内仍有效,可用于调试,例如:DBMS_OUTPUT.PUT_LINE('Deadlock at ' || SQLERRM); - 不要在
WHEN分支里再RAISE同名异常,否则会无限循环 —— 若需向上抛,用RAISE_APPLICATION_ERROR(-20001, '...');
和 RAISE_APPLICATION_ERROR 的配合边界
PRAGMA EXCEPTION_INIT 只用于捕获 Oracle 内部抛出的错误(如约束违规、死锁),不适用于你自己用 RAISE_APPLICATION_ERROR 抛出的错误。
-
RAISE_APPLICATION_ERROR(-20001, 'Config missing')抛出的错误,其错误码在 -20000 ~ -20999 范围内 - 你可以用
PRAGMA EXCEPTION_INIT绑定它,例如:config_err EXCEPTION; PRAGMA EXCEPTION_INIT(config_err, -20001); - 但更推荐直接在
EXCEPTION块中用WHEN OTHERS THEN IF SQLCODE = -20001 THEN ...,因为自定义错误码是你可控的,没必要额外声明 - 真正需要
PRAGMA的,是那些你无法修改源码、但又想精准拦截的 Oracle 内部错误(比如-2292、-1)
最容易被忽略的是作用域和声明顺序 —— 多数编译错误不是因为错误码选错,而是异常变量和 PRAGMA 没紧挨着,或者放在了子过程外面。写完立刻用 SHOW ERRORS 检查,比运行时报错再排查快得多。











