Wagtail 6.3迁移报错：BlogPage含未知字段comment_notifications

问题分析 #

comment_notifications字段来自Wagtail的PageSubscription订阅模块，你没在BlogPage模型或BlogPageForm里定义却触发错误，核心原因是自定义表单的字段配置逻辑导致Django误将关联模型的字段当成BlogPage的字段处理。

解决方案 #

1. 修正自定义表单的字段配置

最常见的问题是BlogPageForm的Meta类用了fields = '__all__'，这会让Django尝试加载所有关联模型的字段（包括PageSubscription的comment_notifications）。改成明确指定需要的字段：

from wagtail.admin.forms import PageForm
from .models import BlogPage

class BlogPageForm(PageForm):
    class Meta:
        model = BlogPage
        # 只列出你实际需要的字段，比如标题、正文、语言标签等
        fields = ['title', 'body', 'language', 'tags']

如果用exclude，也要确保没有误操作：

class BlogPageForm(PageForm):
    class Meta:
        model = BlogPage
        exclude = ['some_unneeded_field']  # 只排除明确不需要的，不要留空或乱填

2. 检查表单继承与字段添加逻辑

确认BlogPageForm继承的是wagtail.admin.forms.PageForm，而不是其他包含订阅字段的自定义基类。同时排查表单代码里有没有动态添加字段的逻辑，比如self.fields['comment_notifications'] = ...这类误写的代码。

3. 重置迁移文件（谨慎操作）

如果之前生成的迁移文件已经被错误字段污染，先删除migrations目录下除__init__.py以外的所有文件，然后重新生成迁移：

python manage.py makemigrations
python manage.py migrate

注意：如果是生产环境，先备份数据库，避免数据丢失。

4. 排查模型关联问题

确认BlogPage模型没有通过OneToOneField或ForeignKey意外关联到PageSubscription，这种关联会让Django在模型验证时自动加载关联字段，导致迁移报错。

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