导入一批指定ID的数据后，应用下一次插入却报主键重复。此时约束在正常阻止重复值，真正需要确认的是自增列背后的序列是否还停留在旧位置。
序列值与表中最大ID不是自动同步的。手动填入ID或批量迁移数据后尤其要检查这一点。
先确认冲突来自哪一列
记录报错中的约束名与冲突ID，核对表结构、插入语句是否显式提供该列，以及是否有应用自行生成ID。不能只凭duplicate key报错就调用setval。
先查询目标表的max(id)，并确认列确实由序列提供默认值。若冲突来自业务唯一键，调整序列无效。
找到列实际绑定的序列
PostgreSQL官方文档提供pg_get_serial_sequence('public.orders', 'id')查询列关联序列。该函数也适用于identity列；返回空值时，不要猜测序列名称直接修改。
确认表名、模式和列名后再查看序列状态。跨模式或大小写特殊的表名要按实际标识符核对。
理解setval的下一次取值
官方序列函数文档规定，setval(seq, value, true)会使下一次nextval先推进再返回；setval(seq, value, false)会让下一次直接返回指定值。因此在已存在最大ID的表上，两个写法不能混用。
setval的更改对其他会话立即可见，事务回滚也不会撤销。这不是可在生产环境里随意试错的操作。
在受控窗口校正
先备份并暂停或协调相关写入，确认最大的现有ID和序列关联关系。对非空表，在设计允许连续递增且步长为默认值的前提下，可按当前最大ID设置序列，使下一次值避开已占用范围。空表、非默认步长、循环序列和分区场景需要单独计算。
并发写入尚在进行时，单独读取max(id)再setval会产生竞争窗口。应按业务维护方案协调写入，而非复制一条通用修复SQL盲跑。
验证修复范围
在隔离副本验证关联序列、下一次插入和约束行为；可用萤光云或LightNode的独立VPS复现导入流程。生产验收要观察后续正常写入是否不再撞号，并检查应用是否仍显式写入旧ID。
序列允许出现空号；目标是避免重复，不是强行得到无间断编号。
FAQ
问：能用ROLLBACK撤销setval吗？答：不能。官方文档明确序列状态变化不会随当前事务回滚。
问：为什么刚修好又撞号？答：检查是否还有导入任务或应用持续显式插入ID，也要核对是否改错序列。
温馨提示
温馨提示：迁移脚本应把数据导入与序列校验放在同一变更清单，记录修改前后的状态及写入暂停窗口。
