// PostgreSQL 錯誤參考

PostgreSQL 23502:空值違反 NOT NULL 約束

INSERT 或 UPDATE 把 NOT NULL 欄位留空,通常是因為漏列該欄位而又沒有預設值。

SQLSTATE
23502
名稱
not_null_violation
類別
完整性約束違規
錯誤訊息
null value in column "email" of relation "users" violates not-null constraint
DETAIL:  Failing row contains (7, Ada, null).

它的意義

A NOT NULL 每個資料列都必須在該欄位有值。23502 表示新增或更新的資料列 NULL 那裡,可能是明確指定的,也可能是因為該欄位沒有被列入 INSERT 且它的預設值是 NULL.

這 DETAIL 行會顯示整個失敗的資料列。PostgreSQL 13 及之後的版本會在訊息中指名資料表;較舊的版本只會說 null value in column "email" violates not-null constraint.

常見原因

  • 這 INSERT 未列出該欄位,且該欄位沒有 DEFAULT.
  • 應用程式傳送了 NULL,例如未設定的欄位,或查找失敗。
  • INSERT ... SELECT 或一個 UPDATE 搭配未傳回任何列的子查詢,因而產生 NULL.
  • 使用 NOT NULL 現有程式碼不認得的欄位。

如何修正

  1. 提供該值,或給欄位一個預設值。

    INSERT INTO users (id, name, email) VALUES (7, 'Ada', '[email protected]');
    ALTER TABLE users ALTER COLUMN created_at SET DEFAULT now();
  2. 使用 COALESCE 當查找或運算式可能傳回 NULL.

    UPDATE orders o
    SET region = COALESCE((SELECT region FROM customers c WHERE c.id = o.customer_id), 'unknown');
  3. 如果欄位應允許缺失值,請刪除條件約束。

    ALTER TABLE users ALTER COLUMN phone DROP NOT NULL;

安全地重現問題

CREATE TEMP TABLE u (id int, email text NOT NULL);
INSERT INTO u (id) VALUES (1);  -- ERROR: null value in column "email" of relation "u" violates not-null constraint

相關錯誤

更多完整性條件約束違規錯誤

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

// 錯誤更少,修復更快

在 SQLly 裡操作 PostgreSQL

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