Django的APPEND_SLASH斜杠补全机制在哪里生效？无尾斜杠路由会不会404

1. 自动补全斜杠的默认行为和触发环节 #

首先纠正一个常见误区：你当前定义的路由本身不带尾部斜杠，访问对应不带斜杠的路径时会直接匹配成功，不会触发斜杠补全逻辑。
Django 默认开启的自动补全尾部斜杠特性由 APPEND_SLASH = True 配置控制，触发逻辑完全在 CommonMiddleware 中实现，具体执行时机是请求匹配不到任何现有路由时：

• 先判断当前请求路径是否没有以 / 结尾
• 再尝试给路径拼接 / 后检查是否存在匹配的路由
• 如果存在匹配路由，就返回301重定向到拼接后的带斜杠路径；如果匹配不到才返回404。

2. 补全斜杠是否仅手动输入地址生效 #

不是，所有来源的请求都会经过这个逻辑校验，包括a标签跳转、Ajax请求、表单提交等，和请求来源无关。

3. 模板{% url %}标签生成的路径会不会触发404 #

{% url %}生成的路径完全和你path()中定义的路径格式一致：

• 你当前定义的路由是path("articles/<int:pk>", views.get_article, name="article")，没有尾部斜杠，所以生成的a标签href就是/articles/5，访问时会直接命中路由返回200，不会出现404。
• 反过来如果你路由定义时加了尾部斜杠，{% url %}生成的路径也会自带尾部斜杠，同样直接命中路由。

只有一种情况会出现跳转404：你手动把a标签的href写死成了和路由格式不匹配的形式（比如路由不带斜杠你硬加了斜杠，且加斜杠后没有对应路由），才会返回404。

4. APPEND_SLASH的实际作用 #

APPEND_SLASH 不等于「不带斜杠就不能访问路由」，它只是一个兼容重定向逻辑：

• 如果你路由定义不带斜杠，用户访问不带斜杠的路径直接正常访问，不会触发重定向
• 只有当用户访问的无斜杠路径找不到匹配路由，但加斜杠后能找到时，才会触发重定向
• 如果把APPEND_SLASH设为False，上述重定向逻辑就会完全关闭，不管什么情况都不会自动补斜杠。

注意：如果你的项目移除了django.middleware.common.CommonMiddleware，那APPEND_SLASH配置不管设成什么都会失效，因为整个补斜杠逻辑都是这个中间件实现的。

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