为何Django的APPEND_SLASH设置添加静态资源后失效？

原因分析 #

APPEND_SLASH的核心逻辑由CommonMiddleware实现：当请求返回404、请求方法为GET/HEAD、APPEND_SLASH=True且原URL无末尾斜杠时，中间件会尝试解析添加斜杠后的URL，如果该URL能匹配到urlpatterns中的规则，就会触发301/302重定向。

添加static()生成的URL规则后，问题出在以下两点：

• static()的正则匹配特性：static()通过re_path生成正则规则，匹配所有以STATIC_URL开头的路径（包括不存在的静态文件路径）。如果STATIC_URL设为空字符串，这个正则会变成r'^(?P<path>.*)$'——捕获所有请求路径，此时任何不带斜杠的URL都会被serve视图直接返回404，CommonMiddleware检查带斜杠的URL时也会被该规则拦截返回404，自然无法触发重定向。
• Django 4.1.1版本兼容性问题：在该版本中，当urlpatterns包含static()规则时，CommonMiddleware调用resolve()函数检查带斜杠URL是否有效时，可能被static()的正则逻辑干扰，错误判定带斜杠的URL也无法匹配，从而跳过重定向流程。

是否属于Bug？ #

分两种情况：

• 若因STATIC_URL配置错误（如设为空）导致问题，属于使用不当，而非Bug。
• 若STATIC_URL为正常配置（如默认/static/）仍出现失效，这属于Django 4.1.x版本的已知兼容性缺陷，后续4.2及以上版本已修复该问题。

static配置对APPEND_SLASH的影响路径 #

1. static()生成的正则URL规则会被追加到urlpatterns末尾，遍历优先级最低。
2. 请求不带斜杠的URL时，若原urlpatterns无匹配，会触发CommonMiddleware的重定向检查。
3. 若static()的正则规则干扰了resolve()对带斜杠URL的解析（如错误匹配或解析异常），中间件会判定带斜杠的URL也无法访问，跳过重定向。
4. 极端场景下（如STATIC_URL为空），static()规则会捕获所有请求，直接返回404，完全绕过APPEND_SLASH逻辑。

临时解决方法 #

1. 确保STATIC_URL配置正确，保持默认的/static/格式，避免设为空字符串。
2. 手动为需要自动补全斜杠的路径添加不带斜杠的规则，示例：

   urlpatterns = [
       path('', home),
       path('admin/', admin.site.urls),
       path('admin', admin.site.urls),  # 手动添加不带斜杠的规则
   ]
   urlpatterns += static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)
   urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
   

3. 升级到Django 4.2及以上版本，彻底修复该兼容性问题。

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