升级Wagtail后访问后台页面报错：'QuerySet'无'defer_streamfields'属性

针对Wagtail从2.6.2升级到4.0.1后页面列表报错'QuerySet' object has no attribute 'defer_streamfields'的问题，可按以下步骤排查修复：

• 检查自定义Admin类的查询集返回类型
  如果项目中自定义了页面的Admin类（继承自WagtailPageAdmin），确认重写的get_queryset方法返回的是Wagtail的PageQuerySet而非普通Django QuerySet。例如，避免直接使用MyCustomPage.objects.all()，应通过super().get_queryset(request)或Page.objects.all()获取正确的查询集类型。

• 执行Wagtail内容类型修复命令
  跨大版本升级可能导致内容类型关联异常，运行以下命令修复：

  python manage.py wagtail_update_content_type
  

  执行后重启服务，再尝试访问页面列表。

• 排查自定义查询逻辑
  检查项目中是否有通过hooks、信号或其他方式修改页面列表查询集的代码，确保没有将PageQuerySet转换为普通QuerySet（例如误用了Django的QuerySet方法导致类型丢失）。

• 验证INSTALLED_APPS配置
  确认settings.py的INSTALLED_APPS中包含必要的Wagtail核心应用：

  INSTALLED_APPS = [
      # ... 其他应用
      'wagtail.core',
      'wagtail.admin',
      'wagtail.sites',
      # ... 其他Wagtail应用
  ]
  

• 清除缓存
  清除Django缓存（可通过python manage.py clearcache命令）和浏览器缓存，避免旧代码或缓存数据干扰。

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