Wagtail 2.0添加content_panels时出现FieldDoesNotExist错误求助

我之前在Wagtail早期版本踩过类似的坑，结合你的描述，给你几个针对性的排查和解决方向：

1. 别把Block类型当成Django模型字段用（最可能的核心问题） #

你提到“即使是简单的CharBlock也会触发错误”，这大概率是问题根源！

• CharBlock 是Wagtail用于StreamField的内容块类型，它不属于Django模型字段范畴，不能直接通过FieldPanel绑定到content_panels。
• 如果要定义普通文本字段，应该用Django的models.CharField搭配FieldPanel：

  from django.db import models
  from wagtail.core.models import Page
  from wagtail.admin.edit_handlers import FieldPanel
  
  class DetailPage(Page):
      # 正确：使用Django模型字段
      my_text = models.CharField(max_length=255, blank=True)
  
      content_panels = Page.content_panels + [
          FieldPanel('my_text'),
      ]
  

• 若确实需要用CharBlock，得把它放到StreamField里，再用StreamPanel添加到面板：

  from wagtail.core.fields import StreamField
  from wagtail.core.blocks import CharBlock
  from wagtail.admin.edit_handlers import StreamPanel
  
  class DetailPage(Page):
      # 使用StreamField包含CharBlock
      my_stream = StreamField([
          ('text_block', CharBlock()),
      ], blank=True)
  
      content_panels = Page.content_panels + [
          StreamPanel('my_stream'),
      ]
  

2. 确保字段定义在content_panels之前 #

Wagtail初始化编辑面板时，会按顺序读取模型字段。如果content_panels写在字段定义前面，就会出现找不到字段的错误：

• ❌ 错误写法：

  class DetailPage(Page):
      content_panels = Page.content_panels + [
          FieldPanel('my_text'),
      ]
      # 字段定义在面板之后，Wagtail初始化时无法识别
      my_text = models.CharField(max_length=255, blank=True)
  

• ✅ 正确写法：先定义字段，再配置面板（参考第一个示例）

3. 检查模型继承与面板扩展方式 #

如果DetailPage继承自自定义父页面模型，要确保正确扩展content_panels：

• 不要直接覆盖父类的content_panels，而是用父类面板加上自己的面板：

  class ParentPage(Page):
      parent_field = models.CharField(max_length=255, blank=True)
      content_panels = Page.content_panels + [
          FieldPanel('parent_field'),
      ]
  
  class DetailPage(ParentPage):
      child_field = models.CharField(max_length=255, blank=True)
      # 正确扩展父类面板
      content_panels = ParentPage.content_panels + [
          FieldPanel('child_field'),
      ]
  

4. 执行迁移并清除缓存 #

修改模型后，若未及时更新迁移或清除缓存，也会导致字段未被识别：

• 运行迁移命令：

  python manage.py makemigrations
  python manage.py migrate
  

• 重启开发服务器
• 清除Django缓存（若开启了缓存）：

  python manage.py clearcache
  

5. 排查字段命名冲突 #

检查你定义的字段名是否和Wagtail页面模型的内置属性重名（比如slug、seo_title、show_in_menus等），这种命名冲突也会导致字段无法被正确识别。

执行系统检查……由<function check_errors..wrapper at 0x0000005F7CDB5598>启动的线程中出现未处理异常……
这个堆栈信息提示错误发生在系统检查阶段，大概率是模型定义本身存在问题，按照上面的步骤排查应该能解决。

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