PostgreSQL 的 UPSERT 部分更新通过 INSERT ... ON CONFLICT 实现，需显式列出要更新的字段并用 EXCLUDED 引用新值，避免误覆原值；冲突目标必须是主键或唯一索引；EXCLUDED 仅含 INSERT 值，不包含默认值；推荐用 COALESCE 或条件判断防止 NULL 覆盖。
什么是 PostgreSQL 的 UPSERT 部分更新
PostgreSQL 本身没有 UPSERT 关键字，但通过 INSERT ... ON CONFLICT 可以实现“存在则更新部分字段、不存在则插入”的语义。关键在于：你不能只写 UPDATE SET col = EXCLUDED.col 就完事——如果想做「部分更新」（比如只改 email 和 updated_at，不碰 created_at 或 status），就必须显式列出要更新的字段，且确保 EXCLUDED 中有对应值。
ON CONFLICT DO UPDATE SET 必须显式指定字段
常见错误是以为 DO UPDATE 能自动合并新旧值，或者漏写字段导致非预期覆盖（比如把 status 设为 NULL）。正确做法是只在 SET 后列出你**真想更新**的列，并用 EXCLUDED.col 引用 INSERT 语句中传入的新值：
INSERT INTO users (id, email, name, created_at, status)
VALUES (123, 'new@example.com', 'Alice', NOW(), 'active')
ON CONFLICT (id) DO UPDATE
SET email = EXCLUDED.email,
updated_at = NOW();
注意：created_at 和 status 没出现在 SET 子句里，它们不会被修改；updated_at 是计算值，不是来自 EXCLUDED。
-
ON CONFLICT (id)中的约束必须是主键或唯一索引，否则报错there is no unique or exclusion constraint matching the ON CONFLICT specification -
EXCLUDED是一个虚拟表，只包含本次INSERTVALUES 中的值，不包含默认值或序列生成值 - 如果想保留原值（比如只在新值非空时才更新），得加条件：
email = COALESCE(EXCLUDED.email, users.email)
如何避免用错 EXCLUDED 导致字段被清空
最容易踩的坑是：INSERT 语句里某字段传了 NULL（比如前端没传 name），而你在 SET 里写了 name = EXCLUDED.name，结果把原来正常的 name 改成了 NULL。解决方式有两种：
- 在应用层确保只传需要更新的字段（推荐）——INSERT VALUES 只包含你想设的字段，其余字段不出现
- 在 SQL 层加判断：
name = CASE WHEN EXCLUDED.name IS NOT NULL THEN EXCLUDED.name ELSE users.name END - 用
COALESCE更简洁：name = COALESCE(EXCLUDED.name, users.name)，但注意：如果EXCLUDED.name是空字符串而非NULL，它不会触发 fallback
别依赖 DEFAULT 行为——EXCLUDED.col 不会回退到列默认值，它就是你 INSERT 里写的那个值（哪怕你是 NULL）。
性能与并发安全的关键点
ON CONFLICT 是原子操作，不会因并发插入产生重复记录，但要注意锁粒度：
- 冲突检测基于唯一约束，所以锁的是对应索引项，不是整张表
- 如果频繁在同一个
id上 UPSERT，可能引发行级锁等待，尤其当DO UPDATE里有子查询或函数调用时 - 避免在
SET中调用耗时函数（如pg_sleep()、复杂 JSON 解析），它会在每次冲突时执行 - 若需根据旧值计算新值（如计数器
counter = users.counter + 1），直接写counter = users.counter + 1即可，users指向当前已存在的行
真正容易被忽略的是：EXCLUDED 和 users 在同一上下文中可见，但你不能在 WHERE 子句（DO UPDATE WHERE ...）里引用 EXCLUDED 的非冲突字段——只有冲突列（如 id）能用于匹配，其他字段只能在 SET 或 WHERE 的右侧表达式里用 EXCLUDED.col。
