Wagtail 6.3本地升级后显示默认欢迎页问题求助

• 检查根页面配置：进入Wagtail后台，依次点击「设置」→「站点」，确认对应站点的「根页面」已选择你的自定义首页，而非默认的Welcome页面。

• 验证数据库迁移：执行python manage.py migrate，确保Wagtail核心模块（如wagtailcore、wagtailadmin）及自定义应用的所有迁移都已完成，无未应用的迁移记录。

• 清理缓存与静态文件：

  • 清除Django缓存：运行python manage.py clearcache（若使用django-cacheops）或通过后台缓存清理工具操作；
  • 重新收集静态文件：执行python manage.py collectstatic --clear，确保静态文件为Wagtail 6.3最新版本。

• 检查URL配置：确认项目根urls.py中正确指向Wagtail站点路由，避免保留旧的默认欢迎页路由。示例正确配置：

  from wagtail import urls as wagtail_urls
  from wagtail.admin import urls as wagtailadmin_urls
  
  urlpatterns = [
      path('admin/', include(wagtailadmin_urls)),
      # 其他自定义URL
      path('', include(wagtail_urls)),
  ]
  

• 确认页面发布状态：在Wagtail后台检查自定义首页是否处于「已发布」状态，草稿页面不会在前端展示。

• 检查站点域名匹配：若本地使用自定义域名，确保站点设置中的「域名」与当前访问域名完全匹配，Wagtail会依据域名匹配对应站点配置。

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