Django表单生产环境ID自增异常：主键重复冲突问题排查

这个错误是典型的数据库自增序列与表中现有数据的最大ID不匹配导致的——生产环境里可能因为手动插入过数据、数据迁移后序列未同步，或者其他操作让序列的下一个生成值已经被表中的记录占用了，而本地测试时序列是跟着数据正常自增的，所以没碰到这个问题。重启gunicorn没用很正常，因为这是数据库层面的问题，和应用服务器无关。

下面是具体的解决步骤：

方法一：直接操作数据库（以PostgreSQL为例） #

1. 先查询目标表的最大ID值（假设你的用户表是auth_user，替换成实际表名）：

SELECT MAX(id) FROM auth_user;

2. 再查看对应序列的下一个生成值（序列名一般是表名_id_seq，比如auth_user_id_seq）：

SELECT nextval('auth_user_id_seq');

3. 如果第二步得到的数值小于等于第一步的最大ID，就重置序列到最大ID+1：

SELECT setval('auth_user_id_seq', (SELECT MAX(id) FROM auth_user) + 1);

方法二：用Django内置工具重置序列 #

如果你不想直接写SQL，可以用Django的sqlsequencereset命令生成重置序列的SQL语句：

1. 执行命令（替换app_name为你的用户模型所在的应用名，比如auth或者自定义的users）：

python manage.py sqlsequencereset app_name

2. 把命令输出的SQL语句复制到数据库客户端执行，或者直接通过管道执行（PostgreSQL示例）：

python manage.py sqlsequencereset app_name | psql -d your_database_name -U your_database_user

做完这些操作后，再尝试提交表单，应该就能正常新增用户了。

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