Django生产环境Files模型对象ID重复致编辑报错排查

核心问题定位 #

生产环境中Files模型所有记录的ID均为0，导致Django执行Files.objects.get(...)时返回多条记录，触发MultipleObjectsReturned异常。这本质是主键自增机制失效，结合你用phpMyAdmin管理数据库（推测为MySQL），以下是具体排查和修复步骤：

1. 检查Files模型的主键配置 #

首先确认模型代码中主键字段的定义：

• 如果是Django自动生成的默认主键（未显式定义id字段），Django会默认创建BigAutoField类型的自增主键，对应MySQL的BIGINT AUTO_INCREMENT字段。
• 如果显式定义了id字段，确保配置正确：

  class Files(models.Model):
      id = models.BigAutoField(primary_key=True, auto_created=True)
      # 其他字段...
  

  避免手动设置id为非自增类型（比如普通IntegerField），否则Django不会自动维护主键的唯一性。

2. 验证生产环境数据库表结构 #

通过phpMyAdmin查看Files表的结构：

• 找到id字段，确认其类型为BIGINT或INT，且勾选了AUTO_INCREMENT属性。
• 如果没有AUTO_INCREMENT，执行以下SQL语句修改表结构（备份数据后操作）：

  ALTER TABLE your_app_files MODIFY COLUMN id BIGINT AUTO_INCREMENT PRIMARY KEY;
  

  （替换your_app_files为实际的表名，Django默认表名是应用名_模型名小写）

3. 修复现有重复ID的数据 #

现有所有Files记录ID为0，需先为它们分配唯一ID：

1. 在phpMyAdmin中执行SQL更新现有记录：

   SET @row_number = 0;
   UPDATE your_app_files SET id = (@row_number:=@row_number + 1);
   

2. 重置表的自增计数器，确保新插入的记录ID从最大现有ID+1开始：

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

4. 排查迁移执行问题 #

• 检查项目migrations目录下关于Files模型的迁移文件，确认主键字段的定义是否包含AutoField/BigAutoField配置。
• 如果迁移文件存在错误，先备份数据，然后删除旧迁移文件（保留__init__.py），重新生成并执行迁移：

  python manage.py makemigrations
  python manage.py migrate --fake-initial  # 避免重复创建表
  

5. 验证Admin功能 #

完成上述修复后，重新尝试通过Django Admin编辑Files对象：

• 此时每条Files记录都有唯一ID，get()方法能正确获取单条记录，异常会消失。

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