Wagtail 6.3.1自定义404/500错误页仅显示基础模板，如何获取完整内容？

问题背景 #

使用Wagtail 6.3.1，希望将指定页面设置为404和500错误页以匹配网站整体风格。创建了对应的错误视图并通过SiteSettings获取配置的错误页面，调用页面的serve()方法返回响应，但测试时仅输出基础模板内容（仅显示标题等极简内容），而非该页面应有的完整渲染结果。

解决方案 #

问题核心在于直接调用page.serve()无法触发Wagtail页面类型对应的完整模板渲染逻辑。以下是修正后的实现方案：

修正后的视图代码 #

from django.http import HttpResponseNotFound, HttpResponseServerError
from django.views import View

class Error404View(View):
    def get(self, request, *args, **kwargs):
        site_settings = SiteSettings.for_request(request)
        if site_settings.error_404_page:
            # 获取具体的页面实例（而非基础Page对象）
            error_page = site_settings.error_404_page.specific
            # 调用render方法获取完整渲染的响应
            response = error_page.render(request)
            # 覆盖响应状态码为404
            response.status_code = 404
            return response
        else:
            return HttpResponseNotFound("NOT FOUND")

class Error500View(View):
    def get(self, request, *args, **kwargs):
        site_settings = SiteSettings.for_request(request)
        if site_settings.error_500_page:
            error_page = site_settings.error_500_page.specific
            response = error_page.render(request)
            response.status_code = 500
            return response
        else:
            return HttpResponseServerError("INTERNAL SERVER ERROR")

关键修正说明 #

• 获取具体页面类型：通过.specific方法将从SiteSettings中取出的基础Page对象转换为你自定义的页面模型（如ContentPage），确保Wagtail使用该页面类型对应的模板进行渲染。
• 使用render()方法：render()会执行Wagtail页面的完整渲染流程，包括加载页面特定模板、填充页面上下文数据，相比serve()更适合自定义视图中的页面渲染场景。
• 设置响应状态码：页面渲染后的默认状态码为200，需手动修改为对应的404或500，保证HTTP状态码的正确性。

额外注意事项 #

• 确认你的自定义页面模型已正确配置template属性，指向对应的页面模板文件。
• 在DEBUG模式下测试时，若要看到自定义错误页，需将settings.DEBUG设为False，或通过配置的测试路由访问（如/404/），否则Django会显示默认调试错误页。

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