Django模型使用CharField作为主键时多对多关联迁移报错如何解决

问题根因 #

报错核心是多对多关系自动生成的中间表外键字段，与ArticleCategory表主键的字段属性不匹配：ArticleCategory的主键是CharField(max_length=10)类型，但Django自动生成中间表时生成的关联外键字段类型/长度/字符集和主键不一致，导致数据库创建外键约束失败。

解决方案 #

按以下步骤操作即可解决：

1. 先删除本次新增多对多字段后生成的错误迁移文件（不要删migrations目录下的__init__.py），如果数据库里已经生成了对应的中间表，也一并删除。
2. 重新执行python manage.py makemigrations生成新的迁移文件后，打开迁移文件找到创建多对多中间表的代码段，检查关联ArticleCategory的外键字段属性：
   • 确保字段类型为models.CharField(max_length=10)，和ArticleCategory主键完全一致
   • 如果类型不对，手动修改迁移文件里的字段属性，保持和主键完全匹配
3. 再执行python manage.py migrate即可正常运行。

如果不想每次手动修改迁移文件，可以显式定义多对多中间表，提前固定字段属性避免自动生成出错：

# 先定义中间表模型
class AdCategoryRelation(models.Model):
    ad = models.ForeignKey(Advertisement, on_delete=models.CASCADE)
    category = models.ForeignKey(
        ArticleCategory,
        on_delete=models.CASCADE,
        # 显式指定关联主键，字段属性自动继承主键配置，避免不匹配
        to_field="ArticleCategory_id"
    )

class Advertisement(models.Model):
    # 原有字段保持不变
    advertisement_categories = models.ManyToManyField(
        ArticleCategory,
        related_name='ArticleAdvertisements',
        # 指定自定义中间表
        through=AdCategoryRelation
    )

如果使用MySQL数据库，还需要额外确认两个关联字段的字符集、排序规则完全一致，比如均为utf8mb4字符集、utf8mb4_general_ci排序规则，属性不同也会触发该报错。

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