通过Wagtail管理后台创建的重定向在WSGI部署的服务器上不生效怎么办

根因定位 #

本地python manage.py runserver启动时，所有请求都会经过Django中间件栈处理，Wagtail重定向规则可以正常匹配。生产环境下Apache/Nginx会优先处理静态资源请求，若请求被Web服务器直接拦截没有转发给WSGI应用，Wagtail的重定向规则就不会触发。

排查步骤 #

1. 校验Wagtail重定向基础配置 #

• 检查settings.py的INSTALLED_APPS列表，确认已添加wagtail.contrib.redirects
• 检查MIDDLEWARE列表，确认wagtail.contrib.redirects.middleware.RedirectMiddleware放在列表的最后一位，中间件顺序错误会导致重定向逻辑被其他中间件拦截
• 登录Wagtail后台，确认重定向规则绑定的站点是生产环境的正式域名，不是开发环境的localhost:8000站点

2. 调整Web服务器转发规则 #

90%以上的同类问题都是静态资源拦截规则配置错误导致的：

Apache 配置修正

不要配置全局规则直接把所有请求指向静态文件目录，添加文件存在性判断，只有实际存在的静态资源直接返回，不存在的请求转发给mod_wsgi处理：

RewriteEngine On
# 静态文件存在则直接返回，否则转发给Wagtail应用
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^ /path/to/your/wsgi.py [L]

Nginx 配置修正

调整try_files规则，避免所有不存在的路径都直接返回React的index.html，区分前端静态路径和Wagtail管理的路径：

# 前端静态资源路径
location / {
    root /path/to/react/static/build;
    # 静态资源不存在时，先转发给Wagtail匹配重定向规则，再返回前端index.html适配前端路由
    try_files $uri $uri/ @wagtail /index.html;
}
# Wagtail应用转发规则
location @wagtail {
    include uwsgi_params;
    uwsgi_pass unix:/run/uwsgi/your_site.sock;
    # 若用Gunicorn等HTTP服务，替换为 proxy_pass http://127.0.0.1:8000;
}

如果你的Wagtail博客有统一的路径前缀（比如/blog/*），可以单独给这个前缀加规则，所有匹配前缀的请求直接转发给Wagtail，不需要判断静态文件是否存在。

3. 验证请求链路 #

• 在Django项目的根urls.py顶部添加临时测试路由，打印所有收到的请求路径，访问你配置的重定向源地址，若日志中没有对应请求，说明Web服务器层已经拦截了请求，没有转发给WSGI应用
• 清空浏览器缓存、Web服务器层缓存后再测试，避免之前的404响应被缓存导致重定向不生效

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