在自有Django项目中配置Wagtail：将首页设为根路径

一、确认URL配置（当前配置已符合要求） #

你的URL配置中已经将Wagtail的页面路由挂载到根路径，这部分无需修改：

from wagtail.admin import urls as wagtailadmin_urls
from wagtail import urls as wagtail_urls
from wagtail.documents import urls as wagtaildocs_urls

urlpatterns = [
    path('admin/', admin.site.urls),
    path('cms/', include(wagtailadmin_urls)),
    path('documents/', include(wagtaildocs_urls)),
    path('', include(wagtail_urls)),  # 正确挂载根路径到Wagtail页面路由
]

二、关键操作：配置Wagtail站点与首页的关联 #

根路径空白的核心原因是Wagtail的站点记录未将根域名映射到你的首页页面，按以下步骤操作：

• 登录Wagtail管理后台（访问/cms/路径）
• 进入左侧菜单的 Settings > Sites
• 编辑现有站点记录（若没有则点击"Add site"新建）：
  • Site name：填写你的站点名称（如"我的博客站点"）
  • Root page：选择当前在/home路径的页面（即你想设为首页的页面）
  • Site hostname：填写服务器IP或域名（如127.0.0.1或你的公网IP）
  • Site port：填写项目运行端口（默认是8000）
• 保存配置后，刷新根路径页面即可生效

三、（可选）替换为自定义HomePage类（对应文档提示） #

如果需要给首页添加自定义字段，可复用bakerydemobase应用中的HomePage模型：

1. 确保base和blog应用已添加到项目的INSTALLED_APPS：

# settings.py
INSTALLED_APPS = [
    # ...其他默认应用
    'base',
    'blog',
]

2. 执行数据库迁移，让自定义模型生效：

python manage.py makemigrations
python manage.py migrate

3. 回到Wagtail后台，创建一个新的HomePage类型页面，再重复第二步的站点配置，将根路径指向这个新页面

文档提示解读：当不使用Wagtail官方项目模板时，系统默认生成的是仅含标题的基础Page类型首页；替换为自定义HomePage后，必须通过站点设置将根域名与该页面绑定，否则无法在根路径正常访问。

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