nginx在请求uri为真实目录且不带斜杠、无显式匹配location、未启用代理指令时，自动301重定向至带斜杠版本；重定向地址由absolute_redirect、server_name_in_redirect和port_in_redirect共同决定。
当请求一个以目录名结尾但不带斜杠的 URI（例如 /app），Nginx 在满足特定条件时会自动返回 301 响应，重定向到带斜杠的版本（/app/）。这不是人为配置的 rewrite，而是 Nginx 内置的目录判定与内部重定向机制在起作用。理解它，关键在于搞清“什么时候触发”、“重定向地址怎么生成”以及“如何控制或禁用”。
什么情况下会自动 301 补斜杠？
该行为仅在以下所有条件同时满足时发生：
- 请求的 URI 对应路径在文件系统中是一个真实存在的目录（如磁盘上真有
/var/www/app/这个文件夹）； - URI 末尾没有斜杠（如访问
/app，而非/app/）； - 当前 location 块中未显式匹配该 URI 路径（即没有
location = /app { ... }或location ^~ /app { ... }这类精确/前缀匹配）； - 且该 location 没有使用
proxy_pass、fastcgi_pass等代理指令直接接管请求（否则 Nginx 不会去查本地目录是否存在）。
简单说：Nginx 发现你没写斜杠，但它在磁盘上找到了同名目录，又没被其他规则提前处理，就会帮你补上并 301 跳转——这是它的默认“友好提示”逻辑。
跳转后的 URL 是怎么拼出来的？
重定向目标地址（Location 响应头）不是固定格式，它受三个指令共同影响，按优先级从高到低依次是：
-
absolute_redirect off：若设为off，Nginx 返回相对重定向（如Location: /app/），浏览器用原请求协议+Host+端口+该路径重建完整 URL； - 若
absolute_redirect on（默认），则进入绝对 URL 拼接流程，此时由以下两个指令决定 Host 和 Port 部分： -
server_name_in_redirect off（推荐）：使用客户端请求头中的Host字段（如用户访问的是https://example.com:8080/app，就跳转到https://example.com:8080/app/）； -
port_in_redirect off：避免在重定向 URL 中显式带上非标准端口（如 8080），只在 80/443 时省略端口；
注意：server_name_in_redirect on（默认值）时，Nginx 会无视请求头 Host，强行用配置中 server_name 的第一个值（比如写的是 server_name _;，跳转就变成 http://_/app/，非常危险）。
如何阻止或自定义这个自动跳转？
有三种主流做法，按场景选择：
-
彻底禁用自动补斜杠：在对应 server 或 location 块中添加
absolute_redirect off;。这样即使命中目录，Nginx 也不发 301，而是尝试查找/app文件；找不到再返回 404（或走 index 指令）。适合纯 API 或单页应用（SPA）路由场景； -
保留跳转但修正域名：确保
server_name正确设置（如server_name example.com;），并设server_name_in_redirect off;。这是最稳妥的线上配置，避免跳转到localhost.localdomain或下划线域名； -
手动接管并精准控制：用正则 location 显式捕获无斜杠路径，主动 return 301。例如：
location ~ ^/app$ {<br> return 301 $scheme://$host/app/;<br>}
这种方式完全绕过内置逻辑，可自由定制跳转协议、Host、甚至加 query 参数。
常见误区与验证方法
很多人误以为这是 rewrite 或 index 指令导致的。其实：
-
index index.html;只影响/app/这种带斜杠的请求，对/app无作用； -
try_files若包含$uri/，也可能触发内部重定向，但那是另一套逻辑（属于内容分发阶段），和这里的目录判定 301 是不同机制； - 验证是否是 Nginx 自动跳转：用
curl -I http://yourdomain/app查看响应头，如果看到HTTP/1.1 301 Moved Permanently和Location:，且配置里没写任何 return/rewrite，基本就是这个机制在工作。
本质上，这是 Nginx 对“目录访问规范性”的一次自动干预。用好它，能统一 URL 格式；忽略它，可能导致跳转错误、SEO 分散或开发联调异常。
