Postgres插入SERIAL主键表报teams_pkey唯一约束冲突如何解决

你对SERIAL类型的认知没有错误：PostgreSQL中SERIAL类型会自动为字段创建关联的自增序列，插入数据时不指定ID字段，数据库会自动读取序列的下一个值作为主键值，正常运行场景下不会出现主键冲突。
生产环境正常、staging环境报错的核心差异来自数据拷贝环节：你从生产同步数据到staging时，仅导入了表中的存量业务数据，没有同步更新teams表ID字段绑定的自增序列的当前计数。
当序列记录的当前值小于表内已存在的ID最大值时，新插入数据自动生成的ID就会和存量数据的ID重复，触发唯一约束冲突报错。生产环境的序列值是跟着日常业务写入持续递增的，不存在序列值落后于表内最大ID的情况，因此不会触发该问题。

按以下步骤重置序列值即可解决问题：

• 先查询teams表ID字段关联的自增序列名称，执行SQL：

SELECT pg_get_serial_sequence('teams', 'ID');

常规返回结果格式为public.teams_id_seq，即对应序列的完整名称。

• 重置序列当前值为表内最大ID+1，将SQL中的序列名替换为上一步查询到的实际值后执行：

SELECT setval('public.teams_id_seq', (SELECT COALESCE(MAX(ID), 0) + 1 FROM teams), false);

执行完成后重试插入逻辑，主键冲突报错就会消失。

• 你给出的建表语句存在语法错误：league_name VARCHAR, 行尾多了一个冗余逗号，实际执行建表时会抛出语法错误，需要删除该多余逗号。
• 后续从生产环境同步数据搭建预发布、测试环境时，如果是手动导入表数据而非使用pg_dump等标准备份工具（标准备份工具会自动同步序列值），需要对所有带自增字段的表统一执行序列重置操作，避免同类问题重复出现。

内容的提问来源于stack exchange，提问作者Richlewis