如何删除Wagtail Page继承类中Django模型的ManyToManyField字段？

错误原因 #

你只注释了模型里的many_to_many_field字段，但Wagtail页面模型的编辑面板配置（比如content_panels）还在引用这个已不存在的字段。当Django和Wagtail尝试生成页面编辑表单时，找不到对应的字段，就抛出了FieldError。另外，直接注释字段也不符合Django迁移规范——Django需要通过明确的迁移步骤追踪字段变更，直接删字段会让迁移系统无法正确识别操作。

正确删除字段的步骤 #

1. 清理编辑面板的字段引用 #

打开MyModel的代码，找到content_panels（或edit_handler）配置块，删掉里面用到many_to_many_field的代码。比如原来的面板配置是：

content_panels = Page.content_panels + [
    # 其他面板项
    FieldPanel('many_to_many_field'),
    # 其他面板项
]

直接移除FieldPanel('many_to_many_field')这一行即可。

2. 生成移除字段的迁移文件 #

先保留模型中的many_to_many_field字段代码不动，运行以下命令生成迁移文件：

python manage.py makemigrations

此时Django会生成一个专门记录“移除字段”操作的迁移文件。

3. 删除/注释模型中的字段 #

现在可以把模型里的many_to_many_field字段直接删除，或者注释掉。

4. 同步变更到数据库 #

最后执行迁移命令，将字段删除的操作同步到数据库：

python manage.py migrate

额外提示 #

如果你的模型没有显式定义content_panels，Wagtail会自动把所有自定义字段加入默认编辑面板。这种情况下，删除模型字段后建议重启开发服务器，再执行迁移，避免缓存导致的引用残留问题。

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