Django urls路径末尾为何要加斜杠(/)？路由配置规范是什么

Django本身没有强制要求路由必须加末尾斜杠，但生态里长期形成了默认带斜杠的通用习惯，背后的逻辑和适用场景可以拆成几个部分说明：

为什么绝大多数示例都带末尾斜杠 #

这个习惯和Django框架的默认设计直接绑定：

• Django默认在settings.py中开启APPEND_SLASH = True配置：如果用户请求的无斜杠路径没有匹配到任何路由，框架会自动返回301重定向，跳转到同路径加斜杠的地址；如果加斜杠的路径存在匹配，就正常返回响应。
• 这个设计对齐了Web早期的静态资源路径语义：带斜杠的路径对应一个目录（比如/blog/对应blog目录，默认返回目录下的index页面），不带斜杠的路径对应一个独立文件（比如/favicon.ico对应根目录下的图标文件），属于传统Web服务的路径规范传承。
• 统一带斜杠可以避免同一资源出现两个可访问URL，减少缓存重复、SEO权重分散的问题。

两种无斜杠路由写法的说明 #

你写的两种无斜杠路由实现里：

# 写法1
re_path(r'login$', obtain_auth_token, name='api_token_auth')
# 写法2
path('login', obtain_auth_token, name='api_token_auth')

两种写法效果完全一致，写法2是Django 2.0之后path语法支持的标准写法，不需要额外用正则，更简洁。只要路由里明确写了无斜杠的匹配规则，请求/api/login时就会直接匹配到对应视图，不会触发APPEND_SLASH的重定向逻辑。

这里要提一个很多人踩过的坑：如果POST请求没有匹配到无斜杠路由，触发APPEND_SLASH的301/302重定向时，绝大多数HTTP客户端（包括浏览器、常用的请求库）会把POST请求转为GET请求，同时丢弃请求体里的参数——这也是很多人写登录接口时，明明发了POST请求带了账号密码，最后报405方法不允许或者参数缺失的核心原因。

什么时候该加末尾斜杠，什么时候可以不加 #

没有绝对的对错，核心看场景和项目统一规范：

• 推荐加末尾斜杠的场景：
  • 面向普通浏览器访问的页面路由，比如文章列表、详情页这类GET请求为主的路径，就算触发重定向用户也无感知，符合大众访问习惯。
  • RESTful语义下的资源集合类接口，比如GET /api/articles/获取文章列表、POST /api/articles/创建文章，和框架默认行为对齐，减少额外配置。
  • 需要统一路径入口，避免同一资源多URL共存的场景。
• 推荐不加末尾斜杠的场景：
  • 你提到的登录、登出、密码重置这类动作型接口，本身语义是独立操作端点而非资源目录，设计成无斜杠路径完全合理，还能避免POST重定向丢参数的问题。
  • 项目整体API规范约定用无斜杠风格时，所有路由统一不加即可，只需要把settings.py里的APPEND_SLASH改为False，关闭自动重定向，避免漏写路由时出现奇怪的跳转问题。
  • 对接第三方支付回调、消息推送回调这类对重定向兼容性极差的接口，必须明确写死匹配路径，不要依赖自动跳转逻辑，避免回调失败。

核心原则：不管选哪种风格，整个项目的路由规则必须统一，不要一部分接口加斜杠一部分不加，否则前后端联调、接口调试时会频繁出现无意义的404错误。

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