Django迁移报错：main_tutorial表外键无效导致无法执行migrate

嘿，我来帮你搞定这个外键约束的问题！首先咱们先拆解一下错误信息：

django.db.utils.IntegrityError: 表'main_tutorial'中主键为'1'的行存在无效外键：main_tutorial.tutorial_series_id字段的值'tutorial_series_id'在main_tutorialseries.id中无对应记录。

这个错误的核心是：你的Tutorial表中有一行数据，它的tutorial_series_id字段被填了字符串'tutorial_series_id'，但TutorialSeries表的id是整数类型，根本不存在这个值的记录，违反了外键的完整性约束，所以migrate直接卡壳了。

为什么会出现这个问题？ #

看你的模型代码，Tutorial的tutorial_series外键默认值设为1，但大概率是在之前的迁移操作中，自动生成的迁移文件出了问题——比如不小心把默认值写成了字段名本身（字符串'tutorial_series_id'），导致数据库里的旧数据被填充了这个无效值；也有可能是你手动修改过数据库数据，误操作把这个字段改成了字符串。

解决步骤 #

情况1：开发环境，数据可以清空或不重要 #

• 第一步：进入Django shell执行命令，删除无效数据

  python manage.py shell
  from main.models import Tutorial
  # 删除tutorial_series_id为无效字符串的记录
  Tutorial.objects.filter(tutorial_series_id='tutorial_series_id').delete()
  

• 第二步：确保TutorialSeries表中有id=1的记录，如果没有就先创建一个：

  from main.models import TutorialCategory, TutorialSeries
  # 先确保有对应的分类
  category, _ = TutorialCategory.objects.get_or_create(tutorial_category="默认分类", category_summary="默认分类摘要")
  # 创建id=1的系列（如果不存在）
  series, _ = TutorialSeries.objects.get_or_create(id=1, tutorial_series="默认系列", tutorial_category=category, series_summary="默认系列摘要")
  

• 第三步：重新运行迁移

  python manage.py migrate
  

情况2：生产环境，不能删除数据 #

• 第一步：通过数据库客户端（比如MySQL命令行、pgAdmin）或者Django shell，找到所有tutorial_series_id为'tutorial_series_id'的Tutorial记录。
• 第二步：将这些记录的tutorial_series_id修改为TutorialSeries表中实际存在的id（比如你已有的某个系列id，或者先创建一个新的系列再关联）。
• 第三步：再次执行python manage.py migrate即可。

额外检查：迁移文件是否有误 #

有时候自动生成的迁移文件会把默认值写错，你可以去main/migrations文件夹下，找到涉及Tutorial模型tutorial_series字段的迁移文件，查看里面的默认值是不是被错误设置成了'tutorial_series_id'，如果是的话，把它改成整数1，再执行迁移即可。

后续建议 #

你的模型中用了default=1作为外键默认值，要确保TutorialSeries表始终存在id=1的记录，否则以后新增数据时还会出问题。如果业务允许，也可以考虑把外键字段设置为允许为空：

tutorial_series = models.ForeignKey(TutorialSeries, null=True, blank=True, verbose_name="Series", on_delete=models.SET_NULL)

这样更灵活，不会因为默认值对应的记录不存在而报错。

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