Django修改主键为字符串类型后插入ID报错求助

错误根源 #

核心问题是仅修改了数据库迁移文件和数据库结构，未同步修正Django模型中的id字段定义。Django ORM的字段校验逻辑完全基于模型代码，而非数据库实际结构：默认情况下，Django会自动为模型添加AutoField类型的id主键（对应INT类型），哪怕手动把数据库改成VARCHAR，ORM层依然会按INT类型校验输入，插入字符串ID时自然会抛出类型错误。

解决步骤 #

1. 修正模型定义 #

在Report模型中显式定义id字段为CharField并设置为主键，覆盖Django的默认主键规则：

class Report(models.Model):
    # 显式定义字符串类型主键，max_length根据你的ID实际长度调整
    id = models.CharField(max_length=20, primary_key=True)
    # 其他字段保持不变...

如果不需要在后台管理界面编辑ID，可添加editable=False参数避免误操作。

2. 同步迁移记录与数据库状态 #

由于之前手动修改过迁移文件，需要让Django的迁移系统与实际数据库状态对齐：

• 先备份数据库（重要，防止数据丢失）
• 删除目标app下migrations目录中除__init__.py之外的所有迁移文件
• 执行命令重新生成迁移文件：

  python manage.py makemigrations
  

• 此时生成的迁移文件会包含将id字段从AutoField改为CharField的操作，但你的数据库已经是VARCHAR类型了，因此用--fake参数让Django标记该迁移已执行：

  python manage.py migrate --fake
  

3. 验证功能 #

用Django ORM插入字符串ID测试：

Report.objects.create(id='230301-001', # 补充其他必填字段...)

此时不会再抛出ValueError，ORM会正确将字符串ID写入数据库。

额外注意事项 #

• 如果数据库中已有旧的INT类型ID数据，需提前将这些ID转换为字符串格式，避免数据不一致
• 自定义字符串主键后，Django不会自动生成ID，你需要自行实现ID生成逻辑（比如按日期+序号的规则生成）

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