Nginx proxy_pass 路径行为：两个流传已久的错误理解

互联网上关于 Nginx proxy_pass 路径行为的描述，存在两个根本性的错误。
这两个错误叠加，导致大多数人对这个行为的理解从根上就是错的。
用错误的概念去理解一个行为，永远无法真正理解它。

错误一：触发条件描述错了

❌ 流传的说法

"proxy_pass 尾部带斜杠会触发路径处理"

✅ 准确说法

proxy_pass 的 URL 中，host:port 之后有没有 path

path 是以 / 开头的，/ 本身就是一个合法的 path。

"尾部斜杠"的说法只在 / 这种最简单的情况下碰巧说得通，
但 http://domain:port/xxx 没有"尾部斜杠"，一样会触发，所以这个描述是错的。

错误二：行为描述错了

❌ 流传的说法

"location 匹配的部分被替换成 proxy_pass 的 path"

✅ 准确说法

location 匹配到的部分溶解消失，URI 的剩余部分追加到 proxy_pass 的 path 后面

"替换"暗示 A 换成 B，B 出现在 A 的位置，容易让人误以为是整体路径的置换。
实际上是两个独立的动作：

1. location 匹配到的部分 → 溶解（消失）
2. URI 剩余部分 → 追加到 proxy_pass 的 path 后面

溶解过程示例

location /foo {
    proxy_pass http://domain:port/a/b/c;
}

请求 URI:        /foo/test.jpg
location 匹配:   /foo          ← 溶解，消失
剩余:                /test.jpg ← 保留
proxy_pass path: /a/b/c
最终请求:        http://domain:port/a/b/c/test.jpg

追加过程是傻瓜式字符串拼接，Nginx 不做任何智能处理：

/a/b/c  +  /test.jpg  =  /a/b/c/test.jpg   ← 正常
/a/b/c/ +  /test.jpg  =  /a/b/c//test.jpg  ← 双斜杠，小心

所以 proxy_pass 的 path 结尾不要带 /。

不触发时：完整透传

location /foo {
    proxy_pass http://domain:port;
}

请求 URI:  /foo/test.jpg
结果:      http://domain:port/foo/test.jpg  ← 原样透传，什么都不发生

为什么这两个错误会让人迷惑一生

• 用错误的概念去理解一个行为，永远无法真正理解它
• 错误的模型无法推导出正确结论，换个场景就又蒙了
• "尾部斜杠"在最常见场景下碰巧说得通，让人以为自己懂了
• "替换"让人怎么想都对不上，反复试、反复查，不知道问题在哪

容易混淆的地方

Nginx 里有两处跟 / 相关的规则，极易串混：

推荐写法

为避免混淆，统一使用不带 path 的 proxy_pass，路径映射交给 rewrite 显式处理：

location /foo {
    rewrite ^/foo(/.*)$ /a/b/c$1 break;
    proxy_pass http://domain:port;
}

行为一目了然，不依赖隐式溶解规则。