Oracle ERRORSTACK 事件診斷實戰：精準定位 ORA-00984 錯誤根因

一、ERRORSTACK 事件機制

Oracle 提供診斷事件機制，可在 Session 級或 System 級設定。針對全局錯誤追蹤，建議 System 級設定，持久化需寫入 SPFILE。

二、實戰案例：追蹤 ORA-00984 "column not allowed here"

1. 設定診斷事件

SQL> ALTER SYSTEM SET EVENT = '984 TRACE NAME ERRORSTACK LEVEL 10' SCOPE = SPFILE;
System altered.

SQL> STARTUP FORCE;
-- Instance restarted with event active

參數解析：

• 984：目標錯誤號 (ORA-00984)
• TRACE NAME ERRORSTACK：輸出錯誤堆疊追蹤
• LEVEL 10：詳細層級 (1-10，10 最詳盡)
• SCOPE=SPFILE：重啟後生效，持久化

2. 觸發錯誤

SQL> CREATE TABLE t (name VARCHAR2(10), id NUMBER);
Table created.

SQL> INSERT INTO t VALUES (a, 1);
INSERT INTO t VALUES (a, 1)
*
ERROR at line 1:
ORA-00984: column not allowed here

錯誤原因：VALUES (a, 1) 中 a 未加引號被視為列名，VALUES 子句不允許列引用。

3. 定位與分析 Trace 檔案

$ cd $ADR_BASE/diag/rdbms///trace
$ ls -lt *.trc | head
conner_ora_18589.trc  (最大、最新)

4. Trace 關鍵內容解讀

*** 2005-03-16 09:06:56.178
ksedmp: internal or fatal error
ORA-00984: column not allowed here
Current SQL statement for this session:
INSERT INTO t VALUES (a, 1)

----- Call Stack Trace -----
calling              call     entry                argument values in hex
location             type     point                (? means dubious value)
-------------------- -------- -------------------- ----------------------------
ksedmp()+269         call     ksedst()+0           0 ? 0 ? 0 ? 0 ? 922C89F ? AA642A0 ?
ksddoa()+446         call     ksedmp()+0           A ? AABDCA8 ? B70100B0 ? 3D8 ? 1 ? B7010114 ?
ksdpcg()+521         call     ksddoa()+0           B70100B0 ? AABDCA8 ?
ksdpec()+220         call     ksdpcg()+0           3D8 ? BFFF3D20 ? 1 ?
ksfpec()+133         call     ksdpec()+0           3D8 ? 3D8 ? AABAE7C ? BFFF3D54 ? 9835E89 ? AA642A0 ?

5. 關鍵資訊提取

三、進階應用技巧

1. 多錯誤同時追蹤：EVENT='984 TRACE NAME ERRORSTACK LEVEL 10, 1000 TRACE NAME ERRORSTACK LEVEL 3'
2. Session 級臨時追蹤：ALTER SESSION SET EVENTS '984 TRACE NAME ERRORSTACK LEVEL 10' (不需重啟，僅影響當前會話)
3. 結合 SQL_TRACE：EVENT='984 TRACE NAME ERRORSTACK LEVEL 10, 10046 TRACE NAME CONTEXT FOREVER, LEVEL 12' 同步獲得綁定變數、等待事件
4. 關閉事件：ALTER SYSTEM SET EVENT = '' SCOPE = SPFILE; STARTUP FORCE;

四、避坑指南

• LEVEL 10 會產生大量 Trace，高併發系統謹慎使用，建議錯峰或限定 Session 級
• Trace 檔案寫入 UDUMP/ADR trace 目錄，確保磁碟空間充足
• 生產庫開啟診斷事件需變更管控，記錄事由、時間、負責人
• ERRORSTACK 僅記錄錯誤發生時堆疊，不包含業務邏輯上下文，需結合應用日誌綜合分析