如何通过RoutablePageMixin修改Wagtail产品页面的URL至根目录？

嘿，我之前刚好处理过一模一样的需求——既要保留Wagtail页面的层级关系（Home > Shop > Category > Product），又要让产品页面能通过根路径（比如/test-product/）直接访问。用RoutablePageMixin确实是正确的思路，下面是一步步的实现方案，亲测有效：

1. 给Product页面模型添加RoutablePageMixin #

首先，我们要给Product页面模型加上RoutablePageMixin——这个Mixin就是用来让Wagtail页面支持自定义路由的，完全不影响原有的层级关系。修改你的产品页面模型：

from wagtail.contrib.routable_page.models import RoutablePageMixin, route
from wagtail.models import Page

class ProductPage(RoutablePageMixin, Page):
    # 这里保留你原来的产品字段，比如：
    # description = RichTextField(blank=True)
    # price = DecimalField(max_digits=10, decimal_places=2)

    template = "product/product_page.html"

    # 定义根路径的路由视图，匹配根路径下的产品slug
    @route(r'^$')
    def root_product_view(self, request):
        # 复用原有的上下文和模板渲染逻辑
        context = self.get_context(request)
        return self.render(request, context)

    # 覆盖get_url方法，让页面的默认URL返回根路径格式
    def get_url(self, request=None, current_site=None):
        # 返回根路径的URL，比如 /test-product/
        return f"/{self.slug}/"

2. 在项目URL配置中添加根路径路由 #

Wagtail默认是按页面层级生成路由的，所以我们需要在项目的urls.py中添加一个优先匹配的路由，让根路径的slug能指向对应的Product页面。注意要把这个路由放在Wagtail默认路由的前面，这样它会优先匹配：

from django.urls import path, include
from wagtail.models import Page
from django.http import Http404
from .models import ProductPage  # 导入你的ProductPage模型

def product_root_view(request, slug):
    try:
        # 通过slug查找对应的Product页面，必须取specific实例才能拿到ProductPage的方法
        product_page = Page.objects.get(slug=slug).specific
        if isinstance(product_page, ProductPage):
            context = product_page.get_context(request)
            return product_page.render(request, context)
    except Page.DoesNotExist:
        pass
    # 找不到对应的产品页面时返回404
    raise Http404("Product not found")

urlpatterns = [
    # 产品根路径路由，放在最前面优先匹配
    path('<slug:slug>/', product_root_view, name='product_root'),
    # Wagtail默认路由，放在后面
    path("", include("wagtail.urls")),
]

3. 可选：让原有层级URL重定向到根路径 #

如果你想让用户访问原来的层级URL（比如/shop/test-category/test-product/）时自动跳转到根路径（对SEO和用户体验更友好），可以给ProductPage加个重定向逻辑：

def serve(self, request):
    # 检查当前请求的URL是否不是根路径
    if request.path != self.get_url():
        from django.shortcuts import redirect
        # 永久重定向（301），对SEO友好
        return redirect(self.get_url(), permanent=True)
    # 正常渲染页面
    return super().serve(request)

验证效果 #

完成以上步骤后，你可以：

• 访问/test-product/直接打开产品页面，页面的层级关系（父级是Category页面）完全不变
• 原来的层级URL会自动重定向到根路径（如果开启了可选步骤）
• 在Wagtail后台中，页面的编辑、预览等功能依然正常，因为我们没有改动页面的层级结构

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