1、普通的insert into
如果（主键/唯一建）存在，则会报错
- 新需求：就算冲突也不报错，用其他处理逻辑
2、基本语法（INSERT INTO ... ON CONFLICT (...) DO (UPDATE SET ...)/(NOTHING)）
语法图
“保留旧数据，
静默跳过”
“用新数据替换或修改旧数据”
“是，只更新部分字段”
“是，需满足条件才更新”
“否，全量覆盖”
开始: INSERT发生主键/唯一冲突
冲突后的期望是?
使用 ON CONFLICT DO NOTHING
使用 ON CONFLICT DO UPDATE SET
需要精细控制吗?
在SET中仅指定目标字段
添加WHERE子句
使用EXCLUDED.*或指定所有字段
🔀 两种核心处理逻辑
为了方便你对比和理解，我将它们总结在下表中：
| 处理逻辑 | 关键字 | 核心行为与目的 | 类比 |
|---|---|---|---|
| 1. 静默放弃 | DO NOTHING | 如果冲突（数据已存在），就什么也不做，静默地保留现有数据，并让语句成功结束。 | “无视”：看到店里已有同样的商品，就决定不放了，直接离开。 |
| 2. 更新覆盖 | DO UPDATE SET ... | 如果冲突（数据已存在），就用新值更新已有的那条记录。 | “置换”：看到店里已有同样的商品，就用你手里的新款替换掉旧款。 |
语法1：DO UPDATE SET
INSERT INTO 表名 (列1, 列2, ...)VALUES (值1, 值2, ...)ON CONFLICT (冲突列[可以多个])DO UPDATE SET列1 = EXCLUDED.列1,列2 = EXCLUDED.列2,...;
语法2：DO NOTHING
INSERT INTO table_name (column1, column2, ...)VALUES (value1, value2, ...)ON CONFLICT (冲突列[可以多个])DO NOTHING;
3、示例
3.1、简单示例
-- 示例1: DO NOTHING - 确保数据唯一，重复则忽略 -- 场景：收集用户邮箱，同一邮箱只记录第一次出现 INSERT INTO user_emails (email, collected_at, source) VALUES ('alice@example.com', NOW(), '官网抽奖') ON CONFLICT (email) DO NOTHING; -- 如果邮箱已存在，则静默跳过，不报错
-- 示例2: DO UPDATE SET - 用最新信息覆盖旧记录 -- 场景：更新用户的最后登录状态 INSERT INTO user_sessions (user_id, last_login_ip, last_login_time, login_count) VALUES (123, '192.168.1.100', NOW(), 1) ON CONFLICT (user_id) DO UPDATE SET last_login_ip = EXCLUDED.last_login_ip, -- 使用本次尝试插入的新IP last_login_time = EXCLUDED.last_login_time, -- 更新时间 login_count = user_sessions.login_count + 1; -- 在原有次数上累加
3.2、ON CONFLICT 多列组合唯一约束示例
场景说明
假设我们有一个学生选课记录表，设计逻辑是：
单个学生可以选多门课
单门课程可以被多个学生选
但 一个学生不能重复选同一门课（即
(student_id, course_id)组合必须唯一）
示例表结构
CREATE TABLE student_courses ( -- 自增主键，但不是业务唯一键 id SERIAL PRIMARY KEY, student_id INT NOT NULL, course_id INT NOT NULL, selected_at TIMESTAMP DEFAULT NOW(), status VARCHAR(20) DEFAULT 'active',
-- 关键：为(student_id, course_id)创建组合唯一约束 CONSTRAINT unique_student_course UNIQUE (student_id, course_id) );
示例数据
假设表中已有数据：
| id | student_id | course_id | selected_at | status |
|---|---|---|---|---|
| 1 | 1001 | 101 | 2024-01-01 | active |
| 2 | 1001 | 102 | 2024-01-02 | active |
| 3 | 1002 | 101 | 2024-01-03 | active |
场景1：尝试重复选课 → 使用 DO NOTHING
学生1001想再次选择课程101（已存在），我们静默拒绝：
INSERT INTO student_courses (student_id, course_id, selected_at) VALUES (1001, 101, NOW()) -- (1001,101)组合已存在！ ON CONFLICT (student_id, course_id) -- 指定两列组合为冲突目标 DO NOTHING; -- 什么都不做，防止重复选课
-- 结果：语句执行成功，但没有插入新行 -- 表数据保持不变
场景2：尝试重复选课 → 使用 DO UPDATE SET
学生1001重复选课101，但我们允许更新选择时间和状态：
INSERT INTO student_courses (student_id, course_id, selected_at, status) VALUES (1001, 101, NOW(), 'renewed') -- 再次尝试选择已选课程 ON CONFLICT (student_id, course_id) -- 检测(student_id, course_id)组合冲突 DO UPDATE SET selected_at = EXCLUDED.selected_at, -- 更新时间戳 status = EXCLUDED.status, -- 更新状态 id = student_courses.id -- 保持原id不变，避免主键冲突
RETURNING *; -- 返回更新后的行
-- 结果：不会创建新行，而是更新id=1的记录 -- 将selected_at更新为当前时间，status更新为'renewed'
场景3：混合情况处理
批量插入选课记录，处理各种冲突情况：
INSERT INTO student_courses (student_id, course_id, selected_at)VALUES (1001, 103, NOW()), -- 新组合：插入成功(1001, 101, NOW()), -- 已存在组合：触发ON CONFLICT(1002, 102, NOW()) -- 新组合：插入成功ON CONFLICT (student_id, course_id)DO UPDATE SETselected_at = EXCLUDED.selected_at,status = 'refreshed'RETURNING student_id, course_id, selected_at;
输出结果可能：
student_id | course_id | selected_at ------------+-----------+-------------------------1001 | 103 | 2024-06-15 10:30:00.000 -- 新插入1001 | 101 | 2024-06-15 10:30:00.000 -- 更新（冲突处理）1002 | 102 | 2024-06-15 10:30:00.000 -- 新插入
3.3、其他多列唯一约束示例
示例1：会议室预订系统
-- 确保同一会议室在同一时间段不被重复预订-- 唯一约束：(room_id, date, time_slot)INSERT INTO room_bookings (room_id, date, time_slot, booker_name)VALUES (101, '2024-06-20', '09:00-10:00', '张三')ON CONFLICT (room_id, date, time_slot)DO NOTHING; -- 时间段冲突则直接拒绝
示例2：用户-产品评分表
-- 确保一个用户对同一产品只能评分一次-- 唯一约束：(user_id, product_id)INSERT INTO product_ratings (user_id, product_id, rating, review)VALUES (5001, 3005, 5, '非常好用')ON CONFLICT (user_id, product_id)DO UPDATE SETrating = EXCLUDED.rating,review = EXCLUDED.review,rated_at = NOW();
关键要点总结
语法格式：
ON CONFLICT (column1, column2, ...)用括号包含多个列约束要求：这些列必须已定义组合唯一约束（可以是复合主键或复合唯一约束）
冲突检测：只有当所有指定列的值都完全匹配时，才被认为是冲突
常见场景：多对多关系表、时间-资源组合、用户-实体关联表等
这种多列约束特别适合处理业务层面的组合唯一性要求，而不仅仅是技术上的主键唯一性。
4、特殊参数解析：冲突列[可以多个]
ON CONFLICT 后面必须指定一个：唯一约束（主键也可以）字段
多个字段唯一也可以
关键机制：
冲突目标：
ON CONFLICT后面必须指定一个唯一约束，通常是主键或唯一索引。当插入的数据在这个约束上与已有数据冲突时，就会触发UPDATE操作。约束要求：这些列必须已定义组合唯一约束（可以是复合主键或复合唯一约束）
EXCLUDED 伪表：在
DO UPDATE SET子句中，你可以使用EXCLUDED.列名来引用本次尝试插入但发生了冲突的那些值，这是实现“用新值覆盖旧值”的关键。
Comments | NOTHING