在 nginx 中，`proxy_pass` 后端路径是否带斜杠直接决定了请求 uri 如何传递给后端服务。如果 `proxy_pass` 指令的 url 包含路径（即带有斜杠），nginx 会将客户端请求中与 location 匹配的部分替换为该路径；如果不包含路径，则直接将完整的原始 uri 传递给后端。例如，当配置为 `proxy_pass http://backend/api/` 时，访问 `/api/test` 会转发给后端的 `/test`；而配置为 `proxy_pass http://backend` 时，同样的请求会转发给后端的 `/api/test`。
location 匹配与 proxy_pass 路径拼接规则
当 `proxy_pass` 指向一个包含路径的 URL 时，Nginx 的行为取决于 location 块的类型以及请求 URI 的具体构成。对于标准的正则或前缀匹配，若 `proxy_pass` 指定了路径，Nginx 会用该路径替换 location 匹配到的部分。这意味着，如果 location 是 `/api/`，且 `proxy_pass` 是 `http://backend/service/`，那么请求 `/api/v1/data` 会被转换为 `/service/v1/data` 发送给后端。这种替换机制允许我们在前端路由和后端接口之间建立映射关系，但需要仔细处理斜杠的数量以避免出现双斜杠或缺失路径的问题。
server {
listen 80;
server_name example.com;
# 情况一：proxy_pass 带斜杠，location 带斜杠
location /api/ {
proxy_pass http://127.0.0.1:8080/backend/;
}
# 情况二：proxy_pass 不带斜杠，location 带斜杠
location /app/ {
proxy_pass http://127.0.0.1:8080;
}
}
在上述配置中，第一种情况访问 `/api/v1/info` 时，Nginx 将 `/api/` 替换为 `/backend/`，最终请求后端的路径为 `/backend/v1/info`。第二种情况访问 `/app/v1/info` 时，由于 `proxy_pass` 没有指定路径，Nginx 保留原始 URI 中的 `/app/` 部分，最终请求后端的路径为 `/app/v1/info`。开发者应根据后端服务的实际接口定义来选择是否添加尾随斜杠，通常建议在后端服务统一规范下，通过调整 Nginx 配置来适配，而不是依赖 Nginx 的隐式替换逻辑。
正则 location 下的 proxy_pass 特殊行为
当使用正则表达式 location（如 `location ~ ^/regex/(.*)$`）时，`proxy_pass` 的行为与前缀匹配有所不同。在正则 location 中，如果 `proxy_pass` 包含路径，该路径会直接追加到捕获组的内容之前，而不是进行简单的字符串替换。这意味着，如果配置为 `proxy_pass http://backend/service/$1;`，请求 `/regex/foo` 将被转发到后端的 `/service/foo`。需要注意的是，正则 location 中不能直接使用变量作为 `proxy_pass` 的目标主机，但可以拼接路径。此外，如果 `proxy_pass` 在正则 location 中未指定路径，它将使用原始请求 URI，这与前缀匹配类似，但捕获组的使用提供了更灵活的路由控制能力。
server {
listen 80;
server_name example.com;
# 正则 location 示例
location ~ ^/images/(.*)\.(jpg|png)$ {
# $1 是文件名，$2 是扩展名
# 这里将请求转发给后端，并保留文件名和扩展名
proxy_pass http://127.0.0.1:8080/media/$1.$2;
}
}
在这个例子中，访问 `/images/logo.png` 会触发正则匹配，`$1` 捕获 `logo`，`$2` 捕获 `png`。Nginx 将请求转发到后端的 `/media/logo.png`。这种机制非常适合需要将前端不同的资源路径映射到后端不同目录的场景。开发者在使用正则 location 时，应确保捕获组的顺序和内容符合后端接口的预期，避免因为路径拼接错误导致 404 或其他异常。同时，正则表达式的性能略低于前缀匹配，因此在可能的情况下，优先使用前缀匹配并结合 `proxy_pass` 的路径替换功能。
如何处理后端返回的重定向路径
当后端服务返回 HTTP 重定向（如 301 或 302）时，Nginx 默认会将 Location 头中的路径原样返回给客户端。如果后端返回的是相对路径或绝对路径，且该路径与 Nginx 配置的 `proxy_pass` 路径不一致，可能会导致客户端浏览器跳转到错误的地址。例如，如果 Nginx 配置 `proxy_pass http://backend/api/`，而后端返回 `Location: /old-api/resource`，客户端可能会尝试访问 `http://example.com/old-api/resource`，这可能与预期的 `http://example.com/api/old-api/resource` 不符。为了解决这个问题，可以使用 `proxy_redirect` 指令来重写后端返回的 Location 头。通过配置 `proxy_redirect http://backend/old-api/ http://example.com/api/;`，Nginx 会在转发重定向响应时，自动将后端的路径替换为 Nginx 暴露给客户端的路径，从而确保重定向的正确性。
