Wagtail编辑器不显示可编辑字段 求助解决方法

针对性排查步骤 #

既然团队和测试环境都正常，仅本地出问题，重点挖本地环境的差异化问题：

• 先抓JS控制台的具体报错：
  • 盯着ReferenceError、TypeError这类关键报错，比如是不是Wagtail的某个核心编辑器模块没加载好，或者变量冲突
• 清Django静态资源缓存：
  • 跑python manage.py collectstatic --clear强制重新收集静态文件，哪怕用runserver也可能有缓存残留
  • 去STATIC_ROOT目录下核对Wagtail的静态文件（比如wagtail/admin/js/里的编辑器核心文件），和测试环境比一比文件完整性、版本号
• 核对依赖版本：
  • 把本地pip freeze的结果和团队的requirements.txt/pyproject.toml逐行比对，尤其是Wagtail、Django的小版本号，差个小版本都可能导致前端资源不兼容
  • 要是有不一致的，直接安装团队指定的版本，别自己乱升级
• 排查数据库数据：
  • 导测试环境的数据库到本地，看问题还在不在，排除本地数据库里页面字段配置出错的可能
  • 新建一个空白页面类型，加几个基础字段测试，看编辑器能不能正常显示，排除特定页面的数据问题
• 检查本地配置和自定义代码：
  • 确认settings.py里DEBUG=True，STATIC_URL没乱改，没自定义路由覆盖Wagtail的静态资源路径
  • 看看本地有没有自定义的Wagtail钩子（hooks.py）或者前端插件，会不会是自己加的代码写错了，导致全局JS崩了
• 检查文件权限：
  • 确认项目目录和STATIC_ROOT的权限没问题，Django能正常读静态文件，虽然DOM能找到资源，但文件损坏或者权限不够也可能导致加载异常

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