Wagtail自定义视图后RichTextField首页不显示的问题

问题背景 #

我用Django/Wagtail搭建首页，页面模型包含RichTextField字段，原本能正常显示后台添加的body内容。但配置自定义视图处理会话（首次访问创建会话）后，出现以下冲突：

• 保留home_views.home路由：会话逻辑生效，但模板中{{ page.body|richtext }}无内容显示
• 注释该路由：能正常显示body内容，但会话逻辑不执行

我需要理解底层原理，让两者同时正常工作，相关代码如下：

Models.py #

class HomePage(Page):
    
    body = RichTextField(blank=True)

    content_panels = Page.content_panels + [
        FieldPanel('body'),
    ]

urls.py #

from home import views as home_views

urlpatterns = [
    path("django-admin/", admin.site.urls),
    path("admin/", include(wagtailadmin_urls)),
    path("documents/", include(wagtaildocs_urls)),
    path("search/", search_views.search, name="search"),
    path("", home_views.home, name="home"),
]

urlpatterns = urlpatterns + [
    # For anything not caught by a more specific rule above, hand over to
    # Wagtail's page serving mechanism. This should be the last pattern in
    # the list:
    path("", include(wagtail_urls)),
    # Alternatively, if you want Wagtail pages to be served from a subpath
    # of your site, rather than the site root:
    #    path("pages/", include(wagtail_urls)),
]

views.py #

from django.template.response import TemplateResponse

def home(request):
    
    if request.session.session_key:
        consent = False
    else:
        request.session.create()
        consent = True
    
    return TemplateResponse(
        request,
        "home/home_page.html",
        {
            "consent": consent,
        },
    )

home_page.html #

{% extends "base.html" %}

{% load wagtailcore_tags %}

{% block content %}

    {{ page.body|richtext }}

{% endblock %}

{% block cookienotice %}
    {% if consent %}

                <br>Consent is true.<br>

    {% endif %}
{% endblock %}

底层原理分析 #

问题出在两个关键点：

1. 路由匹配优先级：Django按路由列表顺序匹配，你的自定义home路由排在wagtail_urls前面，访问根路径时会优先执行自定义视图，跳过Wagtail的页面服务流程。
2. Wagtail页面上下文传递：当使用wagtail_urls时，Wagtail会自动查找对应Page实例（比如你的HomePage），并将page对象注入模板上下文；但你的自定义视图只传递了consent变量，没有传入page对象，导致模板无法渲染page.body内容。

解决方案 #

方法一：自定义视图中手动传入Page实例 #

修改views.py，添加获取HomePage实例的逻辑，将page对象传入模板上下文：

from django.template.response import TemplateResponse
from home.models import HomePage  # 导入HomePage模型

def home(request):
    if request.session.session_key:
        consent = False
    else:
        request.session.create()
        consent = True
    
    # 获取首页实例（Wagtail根页面通常只有一个HomePage）
    page = HomePage.objects.first()
    
    return TemplateResponse(
        request,
        "home/home_page.html",
        {
            "consent": consent,
            "page": page,  # 传入page对象到模板
        },
    )

这样既执行了会话逻辑，又为模板提供了渲染body所需的page对象。

方法二：利用Wagtail页面钩子处理会话（更贴合Wagtail生态） #

无需自定义路由，通过Wagtail的before_serve_page钩子，在页面渲染前处理会话逻辑，保留Wagtail自动传递page对象的机制：

1. 修改home/models.py，添加钩子：

from wagtail.models import Page
from django.http import HttpRequest

class HomePage(Page):
    body = RichTextField(blank=True)

    content_panels = Page.content_panels + [
        FieldPanel('body'),
    ]

    def before_serve_page(self, request: HttpRequest, *args, **kwargs):
        # 处理会话逻辑
        if not request.session.session_key:
            request.session.create()
            request.session['consent'] = True
        else:
            request.session['consent'] = False
        return super().before_serve_page(request, *args, **kwargs)

2. 修改home_page.html，从session中获取consent：

{% extends "base.html" %}

{% load wagtailcore_tags %}

{% block content %}
    {{ page.body|richtext }}
{% endblock %}

{% block cookienotice %}
    {% if request.session.consent %}
        <br>Consent is true.<br>
    {% endif %}
{% endblock %}

3. 注释掉urls.py中的path("", home_views.home, name="home")路由，让wagtail_urls处理根路径访问。

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