Wagtail中RoutablePageMixin自定义页面缓存失效问题求助

核心问题拆解 #

你遇到的问题源于两个关键错误：

1. 路由方法参数缺失：my_route方法未接收request参数，RoutablePageMixin的路由方法必须以self, request, 路由参数的顺序定义，参数缺失会直接导致路由调用失败。
2. 缓存逻辑覆盖不全：当继承顺序为RoutablePageMixin, BasePage时，RoutablePageMixin的serve方法匹配到路由后会直接返回路由响应，不会触发BasePage和CacheMixin的serve逻辑，导致路由响应未被缓存。
3. 错误的serve重写逻辑：你之前重写的serve方法调用super(RoutablePageMixin, self).serve，实际上跳过了RoutablePageMixin的路由处理逻辑，直接调用BasePage的serve，所以路由无法访问。

具体修复步骤 #

1. 修正路由方法参数 #

首先补全my_route方法的request参数：

@route('my_route/<int:category_id>')
def my_route(self, request, category_id):
    # 路由逻辑代码
    return self.render(
        request,
        extra_context={
            "key1": value_1,
            "key2": value_2
        },
        template="my_app/category.html"
    )

2. 重构CacheMixin抽离缓存逻辑 #

将缓存逻辑从serve方法中抽成独立方法，方便在路由响应中复用：

class CacheMixin:
    def apply_cache_headers(self, response):
        # 在这里实现你的缓存逻辑，例如设置缓存头
        response.headers['Cache-Control'] = 'public, max-age=3600'
        # 可添加其他缓存操作，如Vary头、ETag生成等
        return response

    def serve(self, request, *args, **kwargs):
        response = super().serve(request, *args, **kwargs)
        return self.apply_cache_headers(response)

3. 给路由响应应用缓存逻辑 #

修改my_route方法，在返回响应前调用缓存处理方法：

@route('my_route/<int:category_id>')
def my_route(self, request, category_id):
    # 路由逻辑代码
    response = self.render(
        request,
        extra_context={
            "key1": value_1,
            "key2": value_2
        },
        template="my_app/category.html"
    )
    # 应用缓存逻辑
    return self.apply_cache_headers(response)

4. 保持正确的继承顺序 #

CustomPage的继承顺序维持RoutablePageMixin, BasePage，确保路由匹配优先执行：

class CustomPage(RoutablePageMixin, BasePage):
    # 字段定义
    # ...

批量路由的优化方案 #

如果有多个路由方法，不想逐个手动调用缓存逻辑，可以在CustomPage中重写render方法，统一处理所有响应的缓存：

class CustomPage(RoutablePageMixin, BasePage):
    # 字段定义
    # ...

    def render(self, request, template=None, context=None, extra_context=None):
        response = super().render(request, template, context, extra_context)
        return self.apply_cache_headers(response)

    @route('my_route/<int:category_id>')
    def my_route(self, request, category_id):
        # 路由逻辑代码
        return self.render(
            request,
            extra_context={
                "key1": value_1,
                "key2": value_2
            },
            template="my_app/category.html"
        )

这样无论是默认页面响应还是路由页面响应，都会自动经过缓存逻辑处理。

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