// PostgreSQL 错误参考
PostgreSQL 23502:空值违反非空约束
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外键约束冲突23514CHECK 约束冲突515SQL Server:无法将 NULL 值插入列1048MySQL:列不能为空1364MySQL:字段没有默认值ORA-01400Oracle:无法向列插入 NULLSQLITE_CONSTRAINT_NOTNULLSQLite:NOT NULL 约束失败
更多完整性约束冲突错误
代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.
// 错误更少,修复更快
在 SQLly 中使用 PostgreSQL
适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。