如何修复Wagtail4.0旧Django迁移文件PageRevision引用回退报错？

问题根源 #

Wagtail 4.0将PageRevision合并到了Revision模型，旧迁移文件中硬编码的'wagtailcore.pagerevision'外键引用，在回退时会因为Django找不到该模型而触发ValueError。直接修改模型引用或替换迁移中的字符串无法解决回退时的模型解析问题，因为回退流程会严格执行旧迁移文件中的代码。

解决方案 #

方案一：临时代理模型（安全无侵入）

这是最稳妥的方法，不会修改现有迁移历史：

1. 更新当前模型并生成正向迁移
   先确保你的MyModel已经切换到新的Revision引用：

   from wagtail.models import Revision
   
   class MyModel(models.Model):
       revision = models.ForeignKey(
           Revision,
           on_delete=models.CASCADE,
           related_name='my_model_revisions',
           # 保留其他原有参数
       )
   

   运行python manage.py makemigrations生成迁移，再执行python manage.py migrate完成正向更新。

2. 回退前添加临时代理模型
   在你的项目任意已注册的app（比如自定义业务app）中，临时添加以下代码：

   # 在app的models.py中临时添加
   from wagtail.models import Revision
   
   class PageRevision(Revision):
       class Meta:
           proxy = True
           db_table = 'wagtailcore_revision'
           app_label = 'wagtailcore'
   

   这个代理模型会让Django在解析旧迁移中的'wagtailcore.pagerevision'时，自动映射到现有的Revision模型。

3. 执行回退迁移
   运行回退命令，例如：

   python manage.py migrate myapp 0001_initial  # 替换为你要回退到的具体迁移编号
   

4. 清理临时代码
   回退完成后，立即删除刚才添加的PageRevision代理模型，避免影响后续业务逻辑和迁移操作。

方案二：修改旧迁移文件（谨慎操作）

如果你确定所有后续迁移都已兼容Revision，可以直接修改旧迁移文件，但需注意迁移哈希的一致性：

1. 找到创建MyModel的旧迁移文件，将其中的外键引用从'wagtailcore.pagerevision'改为'wagtailcore.revision'：

   # 旧迁移文件中的修改示例
   migrations.CreateModel(
       name='MyModel',
       fields=[
           # 保留其他字段配置
           ('revision', models.ForeignKey(to='wagtailcore.revision', on_delete=models.CASCADE)),
       ],
   )
   

2. 修复迁移哈希
   修改后Django会判定迁移文件被篡改，运行以下命令标记该迁移为已应用状态：

   python manage.py migrate --fake myapp 0001_initial  # 替换为对应的迁移编号
   

3. 同步团队成员
   确保所有开发人员都同步修改后的迁移文件，避免出现团队内迁移状态不一致的问题。

注意事项 #

• 无论使用哪种方案，执行迁移操作前务必备份数据库。
• 方案二仅适合已经完成所有正向迁移、且回退操作不频繁的场景，方案一更适合长期维护的项目。

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