Wagtail中auth_user_pkey唯一约束冲突原因及解决方法咨询

核心问题：数据库自增序列未同步 #

Django的用户表主键是自增字段，依赖数据库的序列对象（比如PostgreSQL的auth_user_id_seq、MySQL的自增计数器）生成下一个ID。你在开发机通过自定义视图直接插入了ID 140-150的用户，这种手动指定主键值的操作不会自动更新数据库的序列计数器。当把数据库迁移到测试机后，测试机的序列计数器还停留在导入前的数值（比如140），所以创建新用户时，数据库会从这个旧值开始生成ID，而这些ID已经被导入的用户占用，直接触发唯一约束冲突。

为什么会出现“复用已存在ID”的现象？ #

这不是Wagtail的问题，是数据库序列的当前值落后于实际已使用的最大主键ID。Wagtail创建用户时调用的是Django标准的用户创建方法，这个方法会让数据库自动生成主键——当序列值比已存在的最大用户ID小，生成的ID自然和已导入的用户重复，看起来像是Wagtail在复用ID，本质是数据库序列没跟上实际数据的主键最大值。

1. 手动更新数据库序列（推荐，一次性解决） #

根据你使用的数据库类型执行对应的SQL命令，把序列值设为当前最大用户ID+1：

PostgreSQL #

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

MySQL #

ALTER TABLE auth_user AUTO_INCREMENT = (SELECT MAX(id) + 1 FROM auth_user);

SQLite #

UPDATE sqlite_sequence SET seq = (SELECT MAX(id) FROM auth_user) WHERE name = 'auth_user';

2. 优化导入逻辑（从根源避免问题） #

以后再通过自定义视图导入用户时，在导入完成后同步更新序列，避免序列落后。比如在Django代码中添加以下函数并在导入结束后调用：

from django.db import connection

def sync_user_sequence():
    with connection.cursor() as cursor:
        cursor.execute("SELECT MAX(id) FROM auth_user")
        max_id = cursor.fetchone()[0]
        if not max_id:
            return
        
        vendor = connection.vendor
        if vendor == 'postgresql':
            cursor.execute(f"SELECT setval('auth_user_id_seq', {max_id + 1})")
        elif vendor == 'mysql':
            cursor.execute(f"ALTER TABLE auth_user AUTO_INCREMENT = {max_id + 1}")
        elif vendor == 'sqlite':
            cursor.execute(f"UPDATE sqlite_sequence SET seq = {max_id} WHERE name = 'auth_user'")

3. 临时应急方案（不推荐长期用） #

在测试机创建用户时手动输入未被占用的ID，但这只是权宜之计，后续创建用户仍可能触发冲突，无法彻底解决问题。

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