无法直接捕获执行中的SQL文本，需通过预设上下文变量、动态SQL显式赋值及错误堆栈反推定位；静态SQL用v_step_desc标记意图，动态SQL必须先赋值再执行，并记录SQL模板、参数和DBMS_UTILITY.FORMAT_ERROR_BACKTRACE()。
不能直接捕获执行中的 SQL 语句文本，但可以通过组合上下文变量 + 动态 SQL 封装 + 错误堆栈反推定位到真实出错语句。
WHEN OTHERS 里拿不到正在执行的 SQL 文本
PL/SQL 的 SQLCODE 和 SQLERRM 只返回错误类型和消息，不包含触发它的那条 SQL；DBMS_UTILITY.FORMAT_ERROR_BACKTRACE() 能指出错误发生在哪一行，但若该行是 EXECUTE IMMEDIATE v_sql，你看到的只是“动态执行这行”，不是 v_sql 本身的内容。
- 常见错误现象：日志里只记下
ORA-00942: table or view does not exist，却不知道是哪条INSERT INTO xxx或SELECT * FROM yyy出的问题 - 根本原因：Oracle 不在运行时保留 SQL 语句的原始字符串快照，尤其对绑定变量、拼接 SQL、动态游标等场景
- 所以必须在执行前主动“打标签”——把语句内容、关键参数、意图写进局部变量或日志上下文
用局部变量显式标记 SQL 意图（最简单有效）
在每段关键 SQL 执行前，把语句摘要存入一个 VARCHAR2 变量，出错时一并输出。这不是自动捕获，而是“人肉埋点”。
- 示例：
DECLARE v_step_desc VARCHAR2(255) := '查询员工薪资'; v_salary NUMBER; BEGIN v_step_desc := 'SELECT salary FROM emp WHERE empno = :1'; SELECT salary INTO v_salary FROM emp WHERE empno = 123; <p>EXCEPTION WHEN OTHERS THEN DBMS_OUTPUT.PUT_LINE('步骤: ' || v_step_desc); DBMS_OUTPUT.PUT_LINE('错误: ' || SQLERRM); DBMS_OUTPUT.PUT_LINE('位置: ' || DBMS_UTILITY.FORMAT_ERROR_BACKTRACE()); END; - 适合静态 SQL 场景；变量名建议统一用
v_step_desc或v_current_sql，避免每个地方起不同名 - 注意别把敏感值（如密码、身份证号）拼进这个变量；只放模板或标识符
动态 SQL 必须把完整语句赋值给变量再执行
所有 EXECUTE IMMEDIATE 或 OPEN cur FOR 的 SQL，必须先赋值给一个 VARCHAR2 变量，而不是直接写字符串字面量。
- 错误写法：
EXECUTE IMMEDIATE 'UPDATE t SET x = 1 WHERE id = ' || v_id;→ 出错时无法还原完整语句 - 正确写法：
v_sql := 'UPDATE t SET x = 1 WHERE id = :1'; DBMS_OUTPUT.PUT_LINE('执行SQL: ' || v_sql); -- 可选调试 EXECUTE IMMEDIATE v_sql USING v_id; - 这样在
WHEN OTHERS中就能输出v_sql，配合USING子句里的参数值，基本可复现问题 - 若 SQL 过长（>32767 字符），需截断记录，但至少保留开头 200 字符 + 关键 WHERE 条件
记录时务必带上 DBMS_UTILITY.FORMAT_ERROR_BACKTRACE() 和参数快照
光有 SQL 文本不够，还要知道它在哪被调用、用了什么参数、事务走到哪一步。
-
DBMS_UTILITY.FORMAT_ERROR_BACKTRACE()必须放在WHEN OTHERS第一行，否则堆栈被覆盖；它返回类似ORA-06512: at "SCOTT.PROC_A", line 87的真实位置 - 关键参数建议打包进日志：比如
v_empno、v_dept_id、v_batch_no，不要只记SQLERRM - 若用自治事务写日志表，记得日志过程自己也要加
PRAGMA AUTONOMOUS_TRANSACTION，否则主事务回滚会连带清空日志 - 示例日志字段建议包含：
procedure_name、error_line（从 backtrace 解析）、executed_sql、bind_params、error_stack
真正难的不是“怎么记”，而是“记哪些才够排障”。动态 SQL 的语句内容、静态 SQL 的上下文变量、错误发生时的堆栈和参数——三者缺一不可。漏掉任意一项，都可能让下次排查多花两小时。
