nginx 对真实存在的目录路径（如/app）且无尾部斜杠时，默认触发301重定向至/app/，由ngx_http_index_module驱动；是否生效取决于目录存在、路径无斜杠、无精确location匹配三条件。
当请求一个目录路径但末尾不带斜杠（如 /app）时，Nginx 默认会返回 301 Moved Permanently，并跳转到带斜杠的版本（/app/）。这不是 bug，而是内置行为——它只在匹配到真实存在的目录、且该路径未被显式 location 捕获时触发。关键在于：这个重定向是否符合预期，取决于你的 server 配置是否清晰定义了域名、端口和重定向逻辑。
为什么 Nginx 会自动加斜杠并 301？
核心触发条件有三个：
- 请求路径指向服务器上一个真实存在的目录（比如磁盘中确实存在
/var/www/html/app/） - 当前请求 URL 末尾没有斜杠（如
/app） - 没有更精确的
location块能完全匹配该路径（例如没有location = /app { ... }或location ^~ /app { ... }）
满足以上三点，Nginx 就会内部发起一次 301 重定向，目标是 原请求 Host + 路径 + /。这个动作由 ngx_http_index_module 模块驱动，与 index 指令配合工作（默认含 index index.html）。
server_name_in_redirect 如何影响跳转地址？
重定向后生成的完整 URL 由这个指令控制，默认值随版本变化：0.8.48 之前为 on，之后为 off。它的作用是决定用哪个域名拼接跳转地址：
-
server_name_in_redirect on：使用server_name指令列出的第一个域名（若未配置，则回退到系统 hostname，如localhost.localdomain） -
server_name_in_redirect off：严格复用客户端请求头中的Host字段（推荐，尤其在负载均衡或非标端口场景下）
例如，访问 http://192.168.1.158:858/hx：
- 若
server_name未设且on→ 跳转至http://localhost.localdomain:858/hx/（可能失败） - 若
server_name 192.168.1.158且on→ 跳转至http://192.168.1.158:858/hx/ - 若
off→ 直接跳转至http://192.168.1.158:858/hx/，无论server_name是否设置
如何关闭或接管这个自动 301？
如果你不希望 Nginx 自动干预，或者想自定义跳转逻辑（比如统一小写、补全协议、兼容旧链接），有两类做法：
-
彻底禁用自动补斜杠：在对应
location中加入index "";，清空 index 指令，让模块不触发目录判定 -
主动 rewrite 控制：用明确规则替代隐式行为，例如：
rewrite ^/([a-zA-Z0-9_-]+)$ /$1/ permanent;
这条规则对所有无斜杠的纯字母数字路径做 301，比内建机制更可控 -
精确 location 匹配兜底：添加
location = /app { proxy_pass http://backend/app/; }，直接终止匹配，避免进入目录判断流程
常见踩坑场景与建议
这类问题多发于开发测试环境或反向代理链路中：
-
前端是 LB，Nginx 听 8080 端口：自动 301 可能跳转到
https://example.com:8080/path/，暴露后端端口。务必设server_name_in_redirect off，并确保 LB 正确透传Host和X-Forwarded-Proto -
泛域名配置
server_name _;：此时server_name_in_redirect on会让跳转变成http://_/path/。必须配off或指定具体域名 - WordPress 或静态站点需 SEO 规范：建议用 rewrite 主动做 301，而非依赖自动行为，便于统一管理缓存策略和历史链接迁移
理解这个机制的关键，是区分“Nginx 的目录服务逻辑”和“你对 URL 形态的业务要求”。自动补斜杠本身合理，但它的输出必须落在你可控的域名和协议上下文中。
