PostgreSQL中ON CONFLICT DO NOTHING遇NULL值不触发冲突如何处理？

安全阿岳

2026-10-4

PostgreSQL 插入含NULL列时冲突跳过解决方案

核心问题根源：PostgreSQL 默认唯一约束规则中，两个NULL值会被判定为不相等，因此你原有写法中的ON CONFLICT无法命中B列为NULL的冲突场景，导致重复行插入成功。

方案1：使用 NULLS NOT DISTINCT 唯一约束（PostgreSQL 15+ 推荐）

PostgreSQL 15 及以上版本支持在创建唯一约束时指定NULLS NOT DISTINCT，直接将NULL视为相等值，完全匹配你的需求。

先为表添加对应唯一约束：

-- 替换为实际表名、约束名
ALTER TABLE your_table_name 
ADD CONSTRAINT unique_a_b_c UNIQUE NULLS NOT DISTINCT (A, B, C);

原有插入语句无需修改即可正常生效：

-- 替换为实际表名
INSERT INTO your_table_name(a,b,c,d)
VALUES(1, null, 2, 5)
ON CONFLICT(A, B, C) DO NOTHING;

方案2：使用表达式唯一索引（兼容 PostgreSQL 15 以下版本）

如果你的数据库版本低于15，可以通过COALESCE函数将NULL替换为业务中不存在的占位值，创建表达式唯一索引实现等效效果：

创建唯一索引，注意占位值需要和列类型匹配，且不会出现在正常业务数据中：

-- 示例中B列为整数类型，用-9999作为NULL的占位值；如果是字符串类型可替换为'__NULL_PLACEHOLDER__'这类值
CREATE UNIQUE INDEX idx_unique_a_b_c ON your_table_name (
  A,
  COALESCE(B, -9999),
  C
);

插入语句的冲突规则需要和索引逻辑保持一致：

INSERT INTO your_table_name(a,b,c,d)
VALUES(1, null, 2, 5)
ON CONFLICT (A, COALESCE(B, -9999), C) DO NOTHING;

方案3：无需修改表结构的插入写法

如果不方便修改表约束或索引，可以直接改写插入语句，用IS NOT DISTINCT FROM语法正确比较NULL值判断重复：

INSERT INTO your_table_name(a,b,c,d)
SELECT 1, null, 2, 5
WHERE NOT EXISTS (
  SELECT 1 FROM your_table_name
  WHERE A IS NOT DISTINCT FROM 1
    AND B IS NOT DISTINCT FROM null
    AND C IS NOT DISTINCT FROM 2
);