Web 服务器与网关 / 系统课时
尾斜杠为什么会影响路由
尾斜杠为什么会影响路由
/api、/api/ 与代理目标末尾的斜杠分别影响不同阶段。本篇先观察 Nginx 给代理型前缀补斜杠的重定向,再查看上游实际收到的路径,避免只看浏览器最终页面就误判发生了什么。
学习目标
- 区分客户端路径、location 前缀与代理目标 URI。
- 观察缺少尾斜杠时的 301 响应。
- 根据上游回显验证路径替换和查询参数。
先区分三处斜杠
客户端请求 /api 与 /api/ 是两条不同路径。location /api/ 表达子路径前缀;当它通过代理等特定指令处理请求时,恰好缺少末尾斜杠的 /api 会触发补斜杠的特殊重定向。仅写一个 return 的普通前缀实验,不一定出现这一行为。
另一处是 proxy_pass http://127.0.0.1:9000/; 的末尾斜杠:它意味着代理目标包含 URI /,在本例中用该 URI 替换命中的 /api/。若写成不带 URI 的 http://127.0.0.1:9000,原始 /api/ 前缀会保留在本例的转发路径中。代理路径规则解释了这一区别。
配置一个能回显路径的上游
练习前准备一个本机 9000 端口的 HTTP 服务,让它把收到的路径及查询字符串原样写入 200 响应体,例如收到 /users?id=7 就返回这一行。该服务应已启动,且不额外跳转;它是下面配置的外部依赖。
片段示例:把下列 server 块放入 http 上下文,检查后重载对应实例。
server {
listen 127.0.0.1:8080;
server_name slash.test;
location /api/ {
# 目标 URI 是 /,因此替换掉本例匹配的 /api/。
proxy_pass http://127.0.0.1:9000/;
}
}该配置中没有精确的 /api 规则,因此该路径会采用代理型前缀的补斜杠行为。为避免自动跟随跳转掩盖第一跳,下面不使用 curl 的 -L。
# 先只看第一跳;再通过上游回显确认实际转发的 URI。
curl -sS -o /dev/null -H 'Host: slash.test' -w 'status=%{http_code}\nredirect=%{redirect_url}\n' http://127.0.0.1:8080/api
curl -sS -H 'Host: slash.test' 'http://127.0.0.1:8080/api/users?id=7'预期输出:
status=301
redirect=http://slash.test:8080/api/
/users?id=7第二个请求状态应为 200。若上游返回没有末尾换行,终端提示符可能紧接其后。此例固定 Host 和监听端口,实际部署的重定向地址还可能受显式重定向相关配置影响,应以响应 Location 为准。

让裸入口行为成为显式决定
若不希望自动 301,可添加 location = /api 明确返回、转发或重定向。对于带请求体的方法,应评估客户端如何跟随 301,不能默认原方法和请求体始终保留;需要保持方法的重定向时,可选择符合业务要求的 307 或 308,并实测客户端。
代理正则 location、命名 location、带变量的目标或 URI rewrite 有各自规则,不能把“加斜杠就去前缀”推广到所有配置。排错时同时记录入口请求、第一跳 Location 和上游实际 URI,才能确认变化发生在哪一段。