如何在Wagtail模型中读取URL参数？request参数失效问题

问题核心原因 #

你遇到的问题本质是Django模板引擎的属性访问规则：当模板中调用{{ page.xxx }}时，如果xxx是不带参数的方法，模板会自动执行它并返回结果；但如果方法需要接收参数（比如你的read_parameter(request)），模板不会自动传递request参数，导致方法未被执行，因此没有输出内容。

解决方法一：通过get_context传递参数（推荐） #

Wagtail的Page类提供了get_context方法，用于向模板传递额外上下文变量。我们可以在这里获取URL参数，再将其注入上下文，模板直接使用该变量即可。

修改models.py：

from wagtail.core.models import Page
from wagtail.core.fields import RichTextField
from wagtail.admin.panels import FieldPanel

class BlogIndexPage(Page):
    intro = RichTextField(blank=True)
    content_panels = Page.content_panels + [
        FieldPanel('intro', classname="full")
    ]

    def get_context(self, request, *args, **kwargs):
        # 先调用父类方法获取默认上下文
        context = super().get_context(request, *args, **kwargs)
        # 从request中提取URL参数，设置默认值避免空值报错
        context['my_parameter'] = request.GET.get('parameter', '')
        return context

对应模板修改：

{% block content %}
<h1>My page</h1>
<p>This should be the parameter: {{ my_parameter }} </p>
{% endblock content %}

解决方法二：模板中手动传递request给模型方法 #

如果需要保留模型方法的方式，可以在模板里调用方法时显式传入request（Wagtail默认会将request注入模板上下文）。

模板修改：

{% block content %}
<h1>My page</h1>
<p>This should be the parameter: {{ page.read_parameter(request) }} </p>
{% endblock content %}

models.py中的方法无需修改：

def read_parameter(self, request):
    my_param = request.GET.get('parameter', '')
    return my_param

为什么模型方法不能自动获取request？ #

Wagtail的Page本质是Django模型，模型的核心职责是数据存储与业务逻辑，设计上不依赖HTTP请求上下文（request）——request属于视图层的请求上下文，只有在处理HTTP请求时才存在。直接让模型依赖request会违反MVC架构的解耦原则，导致代码耦合度升高、可复用性降低。

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