nginx请求路径归一化主要通过merge_slashes指令实现，它在匹配前自动合并连续斜杠，默认on；配合try_files和rewrite可进一步规范目录访问与路径格式，并需通过日志和curl验证生效。
Nginx 中请求路径归一化主要通过 merge_slashes 指令实现，它在请求进入匹配逻辑前自动合并连续斜杠，是路径标准化最基础也最关键的一步。默认已启用，无需额外操作，但需理解其作用边界和配合方式。
merge_slashes：自动合并多斜杠
该指令仅允许出现在 http 块中，取值为 on 或 off，默认为 on。它会在内部将类似 //api///v1//users 的原始 URI 转为 /api/v1/users，再进行 location 匹配与变量赋值（如 $uri）。
- 开启时：
$uri是归一化后的路径，$request_uri仍保留原始值，可用于审计或调试 - 关闭后：所有 location 规则必须显式覆盖多斜杠变体（如
/api//v1/），否则易返回 404 - 错误写法示例：
server { merge_slashes off; }或location /api { merge_slashes on; }—— 会直接导致 nginx 启动失败
配合 try_files 实现路径存在性归一化
当请求指向目录但未带尾部斜杠时（如 /admin），Nginx 默认不自动补 /；若该路径实际对应一个目录，需手动引导，避免 403 或 404。
- 用
try_files $uri $uri/ =404;：先查文件，再查同名目录（触发内部重定向到/admin/） - 搭配
index index.html;，确保访问/admin/时能正确加载首页 - 避免使用
if (-d $request_filename)，因其触发同步文件系统调用，影响性能
用 rewrite + return 统一规范路径格式
对特定语义路径（如版本号、固定前缀），可通过重定向强制客户端使用标准形式，降低后端兼容负担。
- 移除多余路径段：
rewrite ^/(v\d+/)+(.*)$ /$2 permanent;将/v1/v2/v3/api→/api - 统一尾部斜杠：
rewrite ^(.*[^/])$ $1/ permanent;（注意需排除根路径/，可用if ($uri != '/') { ... }控制） - 小写路径标准化：
rewrite ^(/[^A-Z]*[A-Z].*)$ ${lowercase:$1} permanent;（需启用ngx_http_perl_module或改用 Lua）
日志与验证：确认归一化是否生效
仅靠配置无法保证行为符合预期，需结合日志输出与实际请求验证。
- 在
log_format中同时记录原始与归一化路径：log_format norm '$request_uri → $uri'; - 用
curl -I http://host//test///查看响应头，对比Location（如有重定向）或后端收到的$uri - 检查
nginx -t语法无误后，reload 配置并观察 access_log 输出是否符合预期
