如何配置 merge_slashes：处理 URI 中重复斜杠对匹配逻辑的影响-Nginx-PHP中文网

URI中连续斜杠需主动控制：Nginx默认启用merge_slashes进行早期归一化，影响路由匹配与日志审计；关键场景应显式配置on/off，或在应用层统一标准化路径。

如何配置 merge_slashes：处理 uri 中重复斜杠对匹配逻辑的影响

URI 中出现 // 或更多连续斜杠（如 ///）时，虽然多数 Web 服务器（Nginx、Apache）默认会做路径规范化（即自动合并为单个 /），但这个行为不是强制标准，且发生在路由匹配之前还是之后，会直接影响你的应用逻辑是否能正确识别请求。要主动、可控地处理重复斜杠，关键在于启用并配置 merge_slashes（或等效机制）。

理解 merge_slashes 的作用

merge_slashes 是 Nginx 提供的一个指令，用于控制是否在 URI 解析早期阶段就将连续斜杠归一化为单个斜杠。它默认开启（on），意味着：

请求 /api//v1///users 会被内部转成 /api/v1/users 再进入 location 匹配；
后续所有模块（包括 proxy_pass、rewrite、日志记录）看到的都是标准化后的路径；
它不改变响应状态码，也不触发重定向，纯属内部预处理。

何时需要显式配置 merge_slashes

大多数情况无需手动干预，但在以下场景建议明确设置以避免歧义：

你依赖原始 URI 字符串做日志审计或安全分析（如检测异常路径结构），可设为 off 并配合自定义逻辑处理；
使用了自定义的 Lua 脚本或 OpenResty 模块，在 access_by_lua* 阶段需读取未归一化的原始路径；
与某些严格校验 URI 格式的后端服务联调时，发现转发前已被 Nginx 合并，而对方期望保留原始格式（此时应关掉 merge_slashes 并在应用层统一处理）。

Nginx 中的配置方式

在 http、server 或 location 块中添加：

merge_slashes on;  # 默认值，显式声明更清晰
# 或
merge_slashes off;  # 关闭自动合并，交由应用层决定

注意：merge_slashes 不支持在 .htaccess 或运行时动态修改，必须写入主配置并重载 Nginx（nginx -s reload）。

替代方案：应用层标准化更可靠

若你无法修改服务器配置（如托管环境），或希望逻辑完全可控，推荐在应用代码中统一处理：

PHP：用 preg_replace('#/{2,}#', '/', $_SERVER['REQUEST_URI'])；
Node.js（Express）：中间件中 req.url = req.url.replace(/\/{2,}/g, '/');；
Spring Boot：通过自定义 WebMvcConfigurer 或 Filter 拦截并重写 request.getRequestURL()；
Django：结合 CommonMiddleware 和 APPEND_SLASH=False，再用中间件清洗路径。