PostgreSQL 允许空值的状态列写入 NULL 仍报 CHECK 冲突

向允许为空的状态列写入“NULL”，仍然报 violates check constraint。列上只有类似 CHECK (status IN ('Pass', 'Fail')) 的限制，看起来没有要求非空，却连缺失状态也存不进去。

先区分提交的是 SQL 空值，还是四个字符组成的字符串 'NULL'。后者是普通文本，不在允许的状态集合里，会被这个约束拒绝。界面和日志把两者都显示成 NULL 时，单看报错行的文字不够。

下面针对 PostgreSQL 的普通文本状态列及行级 CHECK 约束，示例按当前受支持版本整理。若列另有 NOT NULL、域约束或触发器，真正的空值也可能被拒绝，需要同时检查这些规则。

用布尔结果辨认输入

在本机测试数据库中，以下只读查询可以把两种值的差别显示出来：

SELECT NULL::text IS NULL AS sql_null,
       'NULL'::text IS NULL AS text_null,
       NULL::text IN ('Pass', 'Fail') AS missing_status,
       'NULL'::text IN ('Pass', 'Fail') AS literal_status;

前两列预期分别为真、假；后两列分别为 SQL 空值、假。客户端常把第三列显示为空白，可以再用 IS NULL 包住表达式确认，不要把空白显示当作空字符串。

CHECK 只在条件为假时拒绝行，条件为真或空值时通过。因此，NULL IN ('Pass', 'Fail') 不会违反这个 CHECK；'NULL' IN ('Pass', 'Fail') 则会。给列定义再加一次 NULL 不会把提交的文本转换成空值。

检查真实写入时，对照最终 SQL 与绑定参数的类型。使用参数绑定的应用应提交驱动所定义的空值对象，不应先把所有参数转成字符串。不要为排错打印整条敏感记录；针对状态字段检查是否为空、类型和脱敏后的值即可。

修正写入值，保留状态约束

下面的完整结构只用于专用本机测试连接，创建失败时停止，不要继续操作同名表：

CREATE TEMP TABLE status_null_demo (
    id integer PRIMARY KEY,
    status text CHECK (status IN ('Pass', 'Fail'))
);

INSERT INTO status_null_demo (id, status)
VALUES (1, NULL), (2, 'Pass');

SELECT id, status, status IS NULL AS is_missing
FROM status_null_demo
ORDER BY id;

第一行的 is_missing 应为真，第二行为假。SQL 中的 NULL 不带单引号；'Pass' 是字符串，仍需要引号。也不要把 'NULL' 换成 "NULL"：双引号用于标识符，不能表示 SQL 空值。

在另一次独立测试中，尝试写入 'NULL' 或空字符串 ''，应仍由 CHECK 拒绝。这正是约束的保护作用，不应通过把它们加入允许列表来掩盖输入转换问题。若测试工具开启了事务，预期错误后需要结束该专用测试事务或换新连接；不要在尚有业务修改的连接里试验错误分支。

修正应用时，保留参数化 SQL 的占位符写法，让驱动负责值的编码。各驱动的占位符与空值表示不同，不能把示例 SQL 的字符串拼接进请求参数，也不能给绑定占位符额外套引号。

导入文件中的 NULL 标记要按协议处理

有些导入接口约定文本 NULL 表示缺失值，有些则允许它作为真实文本。只有前一种协议明确成立时，才在导入边界把这个标记转换成 SQL 空值。不要对所有文本列全局执行替换，也不要顺便把 'null'、空字符串和空白都合并为同一种状态。

如果需要接收缺失状态，确认数据模型允许它；如果业务必须有状态，应修正输入或补齐业务信息，保留 NOT NULL。移除非空约束只是让写入通过，不能替代业务判断。

已有记录是否需要清理是另一项工作。先限定受影响批次，核对原始输入及备份，不要根据展示中的 NULL 字样批量更新。文字形式相同的值可能有不同业务含义。

修复后同时验证允许值与拒绝值

至少检查真正空值、两个允许状态、文本 'NULL'、空字符串及一个无效状态。核对数据库中的 status IS NULL 结果，也核对应用读取后是否仍保持缺失值，而没有重新转成字符串。

保存原有 SQL、参数转换代码和少量脱敏样例，便于回退输入层改动。此次修复无需删除 CHECK、重建表或清空数据；回退代码也不会自动恢复已经按新规则写入的数据。测试临时表可以随专用连接关闭而清理。