Wagtail多站点URL跳转至默认站点问题求助

问题核心 #

共用根页面场景下，page.get_url()无法识别当前请求对应的站点（current_site为None），始终返回默认站点的域名，导致跨站点跳转异常。

解决方案 #

1. 修正Wagtail站点中间件配置 #

检查settings.py中的MIDDLEWARE列表，确保wagtail.core.middleware.SiteMiddleware的位置正确——必须放在django.middleware.common.CommonMiddleware之后，且在所有需要调用request.site的中间件之前：

MIDDLEWARE = [
    # 其他基础中间件
    'django.middleware.common.CommonMiddleware',
    'wagtail.core.middleware.SiteMiddleware',  # 关键位置
    # 其他业务中间件（如AuthenticationMiddleware等）
]

2. 显式传递当前请求/站点生成URL #

不要直接使用page.url或page.full_url，而是在模板或视图中主动传入当前请求或站点：

• 模板中调用：

  {{ page.get_url(request=request) }}
  

• 视图中调用：

  from wagtail.models import Page
  
  def your_view(request):
      target_page = Page.objects.get(slug="target-slug")
      # 两种传参方式二选一
      correct_url = target_page.get_url(current_site=request.site)
      # correct_url = target_page.get_url(request=request)
  

  显式传参后，get_url会优先使用当前请求关联的站点生成对应域名的URL，不再 fallback到默认站点。

3. 核对站点配置细节 #

• 站点的域名字段仅填写纯域名（含端口，如127.0.0.1:8000），不要加http://前缀；
• 仅保留一个站点的「Is default site」为勾选状态，避免默认站点冲突；
• 确认两个站点的「Root page」都选择了同一个共用根页面。

4. 自定义模板标签（批量处理场景） #

如果项目中大量使用页面链接，可自定义模板标签简化调用：

# 新建 templatetags/wagtail_custom_tags.py
from django import template
register = template.Library()

@register.simple_tag(takes_context=True)
def site_specific_page_url(context, page):
    request = context.get('request')
    if request and hasattr(request, 'site'):
        return page.get_url(current_site=request.site)
    return page.get_url()

模板中使用方式：

{% load wagtail_custom_tags %}
{% site_specific_page_url page %}

验证方法 #

在模板中添加调试输出，确认当前请求的站点识别是否正常：

当前站点域名：{{ request.site.domain }}

若输出为空，说明SiteMiddleware未正确生效，需重新检查中间件顺序或域名配置。

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