在 nginx 中实现强制重定向到带斜杠路径，核心做法是利用 `rewrite` 指令配合正则表达式匹配末尾非斜杠的 uri，并使用 `last` 标志触发内部重循环。当请求路径以文件名结尾（如 `/api/v1`）时，nginx 会将其重写为 `/api/v1/`，从而触发对目录索引或默认文件的查找逻辑。
如何区分文件请求与目录请求
要准确拦截需要补斜杠的请求，必须理解 Nginx 的文件系统映射机制。Nginx 在处理静态资源时，会根据 `root` 或 `alias` 配置将 URI 映射到磁盘路径。如果映射后的路径是一个普通文件（而非目录），且该文件没有扩展名或不符合特定类型，通常意味着用户漏输了斜杠。通过检查 `is_dir` 和 `is_file` 属性，可以精准定位哪些路径缺失了尾部斜杠。
server {
listen 80;
server_name example.com;
location /api/ {
# 定义根目录
root /var/www/html;
# 关键规则：匹配不以斜杠结尾的路径
# ^(.+[^/])$ 捕获组包含整个路径，确保最后一个字符不是 /
rewrite ^(.+[^/])$ $1/ last;
# 后续处理逻辑
try_files $uri $uri/ =404;
}
}
上述配置中，`rewrite` 指令的正则 `^(.+[^/])$` 确保了只有当 URI 不以 `/` 结尾时才生效。一旦匹配成功，Nginx 会将 URI 修改为追加了 `/` 的版本，并设置 `last` 标志。`last` 标志会导致 Nginx 重新从 `location` 块开始匹配新的 URI `/api/v1/`。此时，由于新 URI 以斜杠结尾，Nginx 会尝试将其视为目录，进而执行 `try_files` 中的 `$uri/` 检查，找到对应的目录索引或 `index.html`。
如何处理带有查询参数的路径
在实际应用中，URL 往往携带查询参数（Query String）。如果直接进行重定向，必须确保查询参数不被丢失。Nginx 的 `rewrite` 指令默认会自动保留原始请求中的查询参数，但为了代码清晰和避免潜在的路径拼接错误，显式处理是更稳妥的做法。我们需要验证在添加斜杠后，原有的 `?key=value` 部分是否依然附加在 URL 之后。
# 测试脚本示例 (使用 curl) # 假设服务器已配置上述 rewrite 规则 curl -I http://example.com/api/v1?key=test # 预期响应头: # HTTP/1.1 301 Moved Permanently (如果配置了 redirect) # 或者 HTTP/1.1 200 OK (如果是内部 last 重写) # Location: /api/v1/?key=test
当使用 `last` 进行内部重写时，客户端浏览器不会感知到重定向，因此地址栏 URL 保持不变，但服务器内部处理的 URI 已经变为带斜杠的形式。如果希望客户端看到重定向（例如返回 301 状态码），可以将 `last` 替换为 `redirect` 或 `permanent`。例如 `rewrite ^(.+[^/])$ $1/ permanent;`。在这种情况下，Nginx 会向客户端发送一个包含新 URI 和原始查询参数的 301 响应，浏览器随后自动发起对新 URL 的请求。无论哪种方式，查询参数都会由 Nginx 自动附加到重写后的 URI 上，无需手动拼接 `&` 或 `?`。
基于 try_files 结果的最终路径确认
强制添加斜杠的最终目的是让 Nginx 正确解析目录结构。然而，仅仅添加斜杠并不保证请求能成功返回内容，还需要确认 `try_files` 是否能找到对应的资源。如果 `/api/v1/` 目录下不存在 `index.html` 或其他默认文件，Nginx 将根据 `try_files` 的最后一个参数返回 404 或执行其他 fallback 逻辑。因此，必须验证在斜杠添加后，文件系统层面的查找是否成功。
在之前的配置中，`try_files $uri $uri/ =404;` 是关键。当 URI 被重写为 `/api/v1/` 后，`$uri` 对应 `/var/www/html/api/v1/`（文件路径），`$uri/` 对应 `/var/www/html/api/v1/index.html`（如果存在）。如果 `/var/www/html/api/v1/` 是一个真实存在的目录，且其中包含 `index.html`，则请求成功。如果该目录为空或不存在 `index.html`，则 `$uri/` 失败，最终触发 `=404`。这种机制确保了只有当路径确实指向一个有效的目录结构时，带斜杠的重写才有意义，避免了将普通文件误判为目录的情况。
