Oracle ORA-00903 錯誤深度解析：無效表名的常見原因與解決方案

錯誤定義

ORA-00903: invalid table name
Cause: A table or cluster name is invalid or does not exist.
       Also issued for invalid cluster name in ALTER/DROP CLUSTER.
Action: Check spelling. Valid name: starts with letter, 
        alphanumeric + $ _ # only, ≤30 chars, not reserved word.

核心命名規則

• 首字元必須為字母 (A-Z, a-z)
• 後續字元：字母、數字、$、_、#
• 長度 ≤ 30 字元
• 不能為保留字（SELECT、TABLE、INDEX、USER 等）
• 不區分大小寫（除非雙引號括起）

案例一：DBMS_SQL 動態 DDL 綁定變數誤用

錯誤代碼：在 DDL 中使用綁定變數

-- 錯誤示範
CREATE OR REPLACE PROCEDURE ddlproc (
    tablename VARCHAR2, colname VARCHAR2, coltype VARCHAR2
) AS
    cursor1 INTEGER;
BEGIN
    cursor1 := DBMS_SQL.OPEN_CURSOR;
    DBMS_SQL.PARSE(cursor1, 'CREATE TABLE :x1 (:y1 :z1)', DBMS_SQL.V7);
    DBMS_SQL.BIND_VARIABLE(cursor1, ':x1', tablename);
    DBMS_SQL.BIND_VARIABLE(cursor1, ':y1', colname);
    DBMS_SQL.BIND_VARIABLE(cursor1, ':z1', coltype);
    DBMS_SQL.EXECUTE(cursor1);
    DBMS_SQL.CLOSE_CURSOR(cursor1);
END;
/
EXEC ddlproc('MYTABLE', 'COL1', 'NUMBER');
-- ORA-00903: invalid table name

原因分析

DBMS_SQL.PARSE 直接執行 DDL，**DDL 不支援綁定變數** 。綁定變數僅用於 DML（SELECT/INSERT/UPDATE/DELETE）。解析時 :x1 被視為字面字串，非合法表名。

正確寫法：字串拼接

CREATE OR REPLACE PROCEDURE ddlproc (
    tablename VARCHAR2, cols VARCHAR2
) AS
    cursor1 INTEGER;
BEGIN
    cursor1 := DBMS_SQL.OPEN_CURSOR;
    DBMS_SQL.PARSE(cursor1, 'CREATE TABLE ' || tablename || ' ( ' || cols || ' )', DBMS_SQL.NATIVE);
    DBMS_SQL.CLOSE_CURSOR(cursor1);
END;
/
EXEC ddlproc('MYTABLE', 'COL1 NUMBER, COL2 VARCHAR2(10)');
-- 成功建立表

案例二：觸發器引用不存在表

ERROR at line 1:
ORA-04098: trigger 'SYSTEM.LOG_ERRORS_TRIG' is invalid and failed re-validation
ORA-00903: invalid table name

診斷步驟

1. 查詢觸發器原始碼：

   SELECT TEXT FROM USER_TRIGGERS WHERE TRIGGER_NAME = 'LOG_ERRORS_TRIG';

2. 檢查觸發器體中引用的表名是否存在：

   SELECT TABLE_NAME FROM USER_TABLES WHERE TABLE_NAME = '引用的表名';

3. 常見原因：
   • 表被刪除/重命名，觸發器未同步更新
   • 觸發器建立時拼寫錯誤
   • 同義詞失效或指向錯誤物件
   • 權限不足導致解析時不可見
4. 修正後重新編譯：

   ALTER TRIGGER LOG_ERRORS_TRIG COMPILE;

其他常見觸發場景

快速診斷清單

1. 確認表名拼寫：SELECT * FROM user_tables WHERE table_name = UPPER('表名');
2. 確認當前 Schema：SHOW USER; 或 SELECT SYS_CONTEXT('USERENV','CURRENT_SCHEMA') FROM DUAL;
3. 確認權限：GRANT SELECT ON schema.table TO user;（非角色）
4. 若使用同義詞：SELECT * FROM user_synonyms WHERE synonym_name = '名稱';
5. 檢查是否為保留字：SELECT * FROM v$reserved_words WHERE keyword = UPPER('名稱');
6. 動態 SQL：列印最終執行字串核對

最佳實踐

• 命名規範：有意義、無保留字、統一大小寫習慣
• DDL 動態執行**絕不使用綁定變數**，改用字串拼接並驗證輸入
• 觸發器/檢視/程序建立後立即驗證 USER_ERRORS
• 部署腳本包含物件存在性檢查與重試邏輯

ORA-00903 看似簡單，實則反映了命名規範、動態 SQL 正確用法、依賴管理等基本功。建立標準化開發部署流程可從根源消除此類錯誤。