nginx反向代理中路径差异化转发的核心是location匹配与proxy_pass配置协同：前缀匹配需注意斜杠规则，正则匹配支持复杂模式，rewrite可精确控制路径重写，map指令实现动态上游选择，须规避斜杠缺失、顺序错位及alias/root混淆等常见陷阱。
在 Nginx 反向代理中，对不同路径做差异化转发，核心是利用 location 指令的匹配规则和 proxy_pass 的灵活配置。关键在于路径匹配的精确性、URI 重写行为的控制，以及避免常见陷阱（比如末尾斜杠引发的路径拼接问题）。
按路径前缀精准匹配并转发
使用 location 的前缀匹配（location /api/）或正则匹配（location ~ ^/admin/.*）可区分不同路径。注意：前缀匹配不带 = 或 ~ 时为最长前缀匹配，且不区分大小写；若需严格区分或支持复杂模式，优先用正则。
-
location /api/ { proxy_pass http://backend-api/; }—— 匹配以/api/开头的请求，且proxy_pass末尾带斜杠，Nginx 会自动剥离/api/并拼接后续路径 -
location /static/ { proxy_pass http://cdn-server; }—— 末尾无斜杠，Nginx 会将完整原始 URI（如/static/js/app.js）原样转发到后端 - 若需保留原始路径但指向不同上游，可用
rewrite配合break或last控制重写流程
处理路径重写与代理路径一致性
当后端服务期望的入口路径与前端暴露路径不一致时（例如前端访问 /v1/users，后端只认 /users），必须显式剥离前缀。最稳妥的方式是在 proxy_pass 后加斜杠，并确保 location 块路径以斜杠结尾。
- 错误写法：
location /v1/ { proxy_pass http://svc; }→ 请求/v1/users会转发为http://svc/v1/users - 正确写法：
location /v1/ { proxy_pass http://svc/; }→ 自动将/v1/users转为http://svc/users - 更灵活场景可用
rewrite ^/v1/(.*)$ /$1 break;+proxy_pass http://svc;，适合需动态调整路径结构的情况
结合变量实现动态上游选择
对于同一路径但需按条件（如域名、请求头、参数）分发到不同后端，可借助 map 指令预定义变量，再在 proxy_pass 中引用。
- 在
http块中定义：map $http_x_env $upstream_host { default backend-prod; "staging" backend-staging; } - 在
location中使用：proxy_pass http://$upstream_host; - 也可基于
$args、$host或自定义 header 判断，实现灰度发布、多租户路由等逻辑
避免常见路径转发陷阱
路径转发出错往往不是逻辑问题，而是 Nginx 对 URI 处理细节的理解偏差。
-
proxy_pass后是否带斜杠，直接决定路径是否被重写 —— 这是最常被忽略的点 - 正则
location ~ \.(js|css|png)$会覆盖所有静态资源，应放在通用location /之前，否则可能被兜底规则捕获 - 使用
alias替代proxy_pass服务本地文件时，alias路径不拼接 location 路径，而root会拼接，二者语义不同，勿混用
