Nginx 中 proxy_pass 末尾斜杠的奥秘

一、proxy_pass 的类型概述

Nginx 的官网将 proxy_pass 分为两种类型：不带 URI 方式和带 URI 方式。

不带 URI 方式只包含 IP 和端口号，例如 proxy_pass http://localhost:8080。而带 URI 方式在端口号之后有其他路径，包括只有单个 “/” 的，如 proxy_pass http://localhost:8080/，以及其他路径，比如 proxy_pass http://localhost:8080/xxx。

这两种类型的处理方式有很大不同，理解它们的区别对于正确配置 Nginx 反向代理至关重要。

1、 在不带 URI 方式下，nginx 将会保留 location 中路径部分，当访问 http://localhost/api1/xxx 时，若配置为

location /api1/ {
    proxy_pass http://localhost:8080;
}

会代理到 http://localhost:8080/api1/xxx

2、 在带 URI 方式下，nginx 将使用诸如 alias 的替换方式对 URL 进行替换，例如当访问 http://localhost/api2/xxx 时，若配置为

location /api2/ {
    proxy_pass http://localhost:8080/;
}

http://localhost/api2/（注意最后的 “/”）被替换成了 http://localhost:8080/，然后再加上剩下的 “xxx”，于是变成了 http://localhost:8080/xxx。了解这两种类型的特点，能帮助我们在实际应用中更加准确地配置 Nginx，确保反向代理的正确运行。

二、不带 URI 方式详解

（一）举例与原理

为了更好地理解不带 URI 方式的工作原理，我们来看更多的例子。假如客户端请求为：http://localhost/test3/xxx，配置为

location /test3/ {
    proxy_pass http://localhost:8080;
}

按照不带 URI 方式的规则，首先保留 location 后的所有内容，即 http://localhost/test3/xxx。然后拼接代理路径后面，最终请求为 http://localhost:8080/test3/xxx。

再看一个例子，客户端请求为：http://localhost/test4/xxx，配置为

location /test4/ {
    proxy_pass http://localhost:8080;
}

同样，先保留 location 后的所有内容，得到 http://localhost/test4/xxx。接着拼接代理路径，最终请求变为 http://localhost:8080/test4/xxx。

通过这些例子可以看出，在不带 URI 方式下，无论 location 中的路径具体形式如何，Nginx 都会严格按照 “保留 location 后的内容，拼接代理路径后” 的规则进行处理。

（二）总结特点

不带 URI 方式确实较为简单直接。在实际应用中，我们无需过多考虑复杂的路径替换规则，只要记住无论 location 中带不带右斜杠，都将其后面的内容直接拼接到代理路径后即可。这种方式在一些场景下可以快速实现反向代理的配置，提高配置效率。同时，由于其规则简单，也减少了出现配置错误的可能性。例如，在一些小型项目或者对反向代理要求不高的场景中，不带 URI 方式可以满足基本的代理需求，并且易于理解和维护。总之，不带 URI 方式以其简洁性和稳定性在 Nginx 的反向代理配置中有着特定的应用场景和价值。

三、带 URI 方式剖析

（一）举例与规则

假如客户端请求为：http://localhost/test7/xxx，配置为

location /test7/ {
    proxy_pass http://localhost:8080/aaa/bbb/;
}

按照带 URI 方式的规则，首先在客户端请求去除 location，获得剩下的右侧内容，即 xxx（获得的右侧内容）。然后拼接到代理路径中，最终请求为 http://localhost:8080/aaa/bbb/xxx。

再如，客户端请求为：http://localhost/test8/xxx，配置为

location /test8 {
    proxy_pass http://localhost:8080/ccc;
}

同样先去除 location，获得右侧内容 /xxx（获得的右侧内容）。接着拼接到代理路径中，最终请求为 http://localhost:8080/ccc/xxx。

通过这些例子可以清晰地看到，在带 URI 方式下，无论代理路径的具体形式如何，总是先去除 location，然后将剩余的右侧内容拼接到代理路径中。这种方式相对不带 URI 方式更加复杂，需要仔细考虑代理路径的具体配置，以确保最终的请求路径正确。

（二）总结建议

如前文所述，当 location 和 proxy_pass 中有一个不带斜杠时，最终的请求路径就可能出现不同寻常的情况。例如，客户端请求为 http://localhost/test9/xxx 时

location /test9 {
    proxy_pass  http://localhost:8080/ddd/;
 }

最终请求为 http://localhost:8080/ddd//xxx  这里会出现路径拼接错误的情况。

因此，为了避免出现这种错误，建议在配置 Nginx 反向代理时，要不 location 和 proxy_pass 都带斜杠，要不都不带。这样可以确保路径拼接的正确性，减少配置错误的可能性。在实际应用中，我们应该根据具体的需求和场景，谨慎选择带 URI 方式或不带 URI 方式，并严格遵循这个建议，以确保 Nginx 反向代理的稳定运行。