merge_slashes指令控制Nginx是否合并URL中连续斜杠，默认on；启用时$uri为标准化路径，$request_uri保持原始URI；关闭后二者均保留多斜杠，需谨慎用于特殊场景。
Nginx 的 merge_slashes 指令用于控制是否自动合并 URL 路径中连续的多个斜杠（//、/// 等）为单个斜杠（/）。该指令作用于 http 块，影响所有 server 和 location 的请求路径预处理行为。
merge_slashes 的作用与默认值
当启用时（默认为 on），Nginx 在解析请求 URI 阶段就会将形如 /a//b///c 的路径标准化为 /a/b/c，后续的 location 匹配、变量（如 $uri、$request_uri）取值均基于合并后的路径。这有助于避免因冗余斜杠导致 location 未匹配或 rewrite 规则异常。
-
merge_slashes on;：默认开启，推荐保持，符合 HTTP 路径语义惯例 -
merge_slashes off;：关闭后，/foo//bar不会变成/foo/bar，$uri保留原始多斜杠形式
对 $uri 和 $request_uri 的影响
$uri 是经过解码、规范化（含 merge_slashes、去除 query string、去除尾部 ? 等）后的路径；而 $request_uri 始终是客户端原始请求行中的完整 URI（包括参数和原始斜杠）。
- 请求
GET /api/v1///users?name=jack且merge_slashes on：-
$uri→/api/v1/users -
$request_uri→/api/v1///users?name=jack
-
- 若设为
off，则$uri也会保留/api/v1///users，可能造成 location ~ ^/api/v1/users$ 无法匹配
何时需要关闭 merge_slashes？
极少数场景需保留原始路径结构，例如：
- 后端服务显式依赖多斜杠作为分隔标记（如某些旧版 CGI 或定制协议）
- 需在 rewrite 或 log 中精确记录原始路径格式用于审计
- 配合正则 location 精确匹配含多斜杠的特定模式（不推荐，应改用更健壮的逻辑）
注意：关闭后需同步检查所有 location 定义、rewrite 条件及 proxy_pass 路径拼接，防止匹配失败或路径错误。
配置示例与验证方法
在 http 块中设置：
http {
merge_slashes off; # 全局关闭
server {
listen 80;
server_name example.com;
<pre class="brush:php;toolbar:false;"> location /test/ {
return 200 "URI: [$uri]\nRequest-URI: [$request_uri]\n";
}
}
}
用 curl 测试：curl 'http://example.com/test//abc'，观察响应中两个变量的差异即可确认是否生效。
