// PostgreSQL 錯誤參考
PostgreSQL 23502:空值違反 NOT NULL 約束
INSERT 或 UPDATE 把 NOT NULL 欄位留空,通常是因為漏列該欄位而又沒有預設值。
- SQLSTATE
23502- 名稱
not_null_violation- 類別
- 完整性約束違規
它的意義
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現有程式碼不認得的欄位。
如何修正
-
提供該值,或給欄位一個預設值。
INSERT INTO users (id, name, email) VALUES (7, 'Ada', '[email protected]'); ALTER TABLE users ALTER COLUMN created_at SET DEFAULT now();
-
使用
COALESCE當查找或運算式可能傳回NULL.UPDATE orders o SET region = COALESCE((SELECT region FROM customers c WHERE c.id = o.customer_id), 'unknown');
-
如果欄位應允許缺失值,請刪除條件約束。
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
相關錯誤
23505重複鍵違反唯一約束23503外鍵條件約束違規23514檢查條件約束違規515SQL Server:無法將 NULL 值插入欄位1048MySQL:欄位不能為 null1364MySQL:欄位沒有預設值ORA-01400Oracle:無法將 NULL 插入欄位SQLITE_CONSTRAINT_NOTNULLSQLite:NOT NULL 約束失敗
更多完整性條件約束違規錯誤
程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.
// 錯誤更少,修復更快
在 SQLly 裡操作 PostgreSQL
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。