// PostgreSQL 错误参考

PostgreSQL 23502:空值违反非空约束

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 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。