nginx代理转发中保持原始路径的关键在于明确控制location匹配段与proxy_pass末尾斜杠的组合逻辑：无斜杠则完整转发，有斜杠则截断匹配段；还需设置host、x-real-ip等代理头，并支持正则重写动态路径。
在 Nginx 代理转发中保持原始路径，关键不是“保持”，而是**明确控制路径如何被截取或拼接**——因为 Nginx 默认会做路径处理，所谓“保持”其实是避免意外截断或重复拼接。真正起决定作用的是 location 的匹配方式和 proxy_pass 末尾斜杠的有无。
理解 location 匹配段与 proxy_pass 的拼接逻辑
当请求进入 Nginx，先由 location 匹配出 URI 中的“匹配段”，再由 proxy_pass 决定是否去掉该段：
-
location /api/ { proxy_pass http://backend/; } → 匹配段
/api/被自动截掉，只转发剩余部分（如/users） -
location /api/ { proxy_pass http://backend; } → 匹配段不被截，完整 URI（如
/api/users）原样拼到后端地址后
想让后端收到完整原始路径，用无尾斜杠写法
若后端服务接口路径本身就带前缀（比如后端自己暴露 /api/users），且你希望 Nginx 不做任何路径干预，就采用：
- location 块按需定义（如
location /api/或location /v1/） -
proxy_pass后不加/，例如：proxy_pass http://127.0.0.1:8080; - 这样请求
/api/users?id=1会转发为http://127.0.0.1:8080/api/users?id=1
需要保留原始 Host 和路径结构，别忘了设代理头
仅靠 proxy_pass 不足以让后端“感知”原始请求上下文。必须显式传递关键头信息：
-
proxy_set_header Host $host;—— 防止后端因 Host 错误拒绝请求 -
proxy_set_header X-Real-IP $remote_addr;—— 传真实客户端 IP -
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;—— 支持多层代理链路还原 -
proxy_set_header X-Forwarded-Proto $scheme;—— 告知后端原始是 http 还是 https
特殊场景：路径含动态前缀，用正则提取+重写
如果原始路径带租户、版本等变量（如 /t1/v2/resource），又希望后端只收 /v2/resource，可用正则捕获并重写：
location ~ ^/t\d+/(.*)$ { proxy_pass http://backend/$1$is_args$args; }-
$1是捕获的剩余路径，$is_args$args确保查询参数完整透传 - 这样
/t5/v3/users?sort=name就变成/v3/users?sort=name转发
