Wagtail源码中page.route()同时返回page、args、kwargs的原因

Wagtail的route()方法设计为返回三个值的核心原因如下： #

• 预留自定义路由扩展能力
  默认实现中args和kwargs确实为None，这是因为Wagtail默认的页面路由逻辑完全基于后台创建的页面树层级路径，不需要额外传递参数。但route()方法是允许开发者重写的开放接口，当你需要实现动态路由场景（比如单个列表页下通过路径参数渲染不同的详情内容、自定义归档路径等）时，就可以将路径中解析出的动态参数放到args或kwargs中返回，供后续serve()方法处理使用。
  示例自定义实现参考：

from wagtail.models import Page
from django.http import Http404
from .models import Article

class ArticleListPage(Page):
    def route(self, request, path_components):
        # 匹配形如 /article-list/2024/05/ 的归档路径
        if len(path_components) == 2 and all(c.isdigit() for c in path_components):
            year, month = int(path_components[0]), int(path_components[1])
            return self, [], {"year": year, "month": month}
        # 其余场景走默认路由逻辑
        return super().route(request, path_components)
    
    def serve(self, request, *args, **kwargs):
        if "year" in kwargs and "month" in kwargs:
            # 渲染对应年月的归档列表
            return render(request, "article_archive.html", {
                "year": kwargs["year"],
                "month": kwargs["month"],
                "page": self
            })
        # 默认渲染全量文章列表
        return super().serve(request, *args, **kwargs)

• 支撑官方内置扩展功能
  Wagtail官方自带的RoutablePageMixin扩展完全依赖这个返回结构实现，这个功能允许开发者在单个页面下通过装饰器注册多个子路由，路由匹配过程中解析出来的路径参数会自动填充到args和kwargs中，传递给对应的处理函数，这类场景下两个参数就会有实际业务值。

• 保持向前兼容性
  这个三返回值的结构从Wagtail早期版本就已经确定，大量第三方插件、开发者自定义的站点逻辑都依赖这个接口结构，如果修改返回值会造成大范围的破坏性变更，所以即使默认实现中两个参数为空，也会保留这个设计。

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