// PostgreSQL 錯誤參考

PostgreSQL 42703:欄位不存在

查詢裡的欄位名稱在它看得到的資料表中不存在。通常是拼字錯誤、大小寫不合,或是把字串值寫成了雙引號。

SQLSTATE
42703
名稱
undefined_column
類別
語法錯誤或存取規則違反
錯誤訊息
column "emial" does not exist
LINE 1: SELECT emial FROM users;
               ^
HINT:  Perhaps you meant to reference the column "users.email".

它的意義

PostgreSQL 無法將欄位參考符合到 FROM 子句。如果有相似名稱存在,最近的版本會多加一個 HINT 才會建議該項目。

造成大多數這類錯誤的,是兩條 PostgreSQL 規則。不加引號的識別碼會自動轉為小寫,所以如果某個欄位建立時叫做 "createdAt" 必須連引號一起寫。而雙引號一律代表識別項,絕不代表字串,所以 WHERE status = "active" 尋找名為 active.

常見原因

  • 打錯字,或欄位已重新命名或還沒新增。
  • 以帶引號的混合大小寫字母建立的欄位 ("userId")被引用時沒加引號。
  • 用雙引號書寫的字串值: WHERE name = "Ada" 而不是 'Ada'.
  • 參照 SELECT 清單別名,位置在 WHERE 或 GROUP BY 的運算式裡,但它在那些地方不可見:別名只能用在 ORDER BY (以及作為純名稱用於 GROUP BY).
  • 使用了資料表別名的欄位,但該別名指的不是那張資料表;或使用了子查詢未選取的欄位。

如何修正

  1. 列出該資料表的實際欄位名稱。

    SELECT column_name, data_type
    FROM information_schema.columns
    WHERE table_schema = 'public' AND table_name = 'users'
    ORDER BY ordinal_position;
  2. 對於值使用單引號,僅對識別碼使用雙引號。

    SELECT * FROM users WHERE status = 'active';
  3. 以建立時的原始形式為混合大小寫的欄位名稱加上引號。

    SELECT "userId", "createdAt" FROM events;
  4. 重複運算式或包裝查詢,而不要在 WHERE.

    SELECT * FROM (
        SELECT id, price * qty AS total FROM order_lines
    ) t
    WHERE total > 100;

安全地重現問題

CREATE TEMP TABLE users (id int, email text);
SELECT emial FROM users;  -- ERROR: column "emial" does not exist

問題

為什麼 WHERE name = "Ada" 會說欄位 Ada 不存在?

在 PostgreSQL 中,雙引號用來標示識別碼,例如欄位或資料表名稱。字串值用單引號:WHERE name = 'Ada'。

相關錯誤

更多語法錯誤或存取規則違規錯誤

程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 PostgreSQL

適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。