Nginx中proxy_pass不支持URI路径含变量，推荐用map预定义upstream映射实现动态后端；次选resolver+变量实现动态DNS解析；或rewrite+proxy_pass组合动态改写路径，三者均需规避常见配置陷阱。
proxy_pass 本身不支持在 URI 路径部分拼接变量，比如 proxy_pass http://$host:$port/api; 会直接报错。这不是配置写法问题，而是 Nginx 架构决定的：URI 解析发生在配置加载时，而变量只在请求处理时才可取值。但真实业务中又确实需要动态后端路径——关键在于绕开限制，用安全、原生、可控的方式实现。
用 map 预定义可信后端映射（最推荐）
这是无需额外模块、兼容性好、逻辑清晰的首选方案。核心是把“判断逻辑”提前到配置解析阶段，用 map 将请求特征（如参数、头信息、路径）映射为已声明的 upstream 名称，再由 proxy_pass 引用该名称。
- 必须先定义 upstream 块，名称要和 map 输出完全一致
- map 块需放在 http 级，不能在 location 内；变量名如 $upstream_name 可在后续 location 中直接使用
- proxy_pass 后只能写
http://$upstream_name，不能加任何路径（否则变量失效）
示例：按查询参数 env 切流量
http {
upstream api_prod { server 10.0.1.10:8080; }
upstream api_staging { server 10.0.2.20:8080; }
map $arg_env $upstream_name {
default "api_prod";
"prod" "api_prod";
"staging" "api_staging";
}
server {
location /api/ {
proxy_pass http://$upstream_name;
}
}
}
用 resolver + 变量触发动态 DNS 解析
当后端地址是域名且 IP 经常变更（如 K8s Service、云函数域名），需每次请求前重新查 DNS。这必须同时满足两个条件：proxy_pass 的值是变量，且同级或外层有 resolver 指令。
- resolver 必须写在 location 或 server 块内，不建议放 http 全局（旧版本不继承）
- set 定义的变量只含域名（不带协议、端口、路径），协议和端口写在 proxy_pass 中
- valid= 时间设为略小于后端 DNS TTL，避免缓存过期后仍连旧 IP
示例：
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
location /legacy/ {
resolver 114.114.114.114 valid=10s;
set $backend "old-api.example.com";
proxy_pass https://$backend:443/;
}
用 rewrite + proxy_pass 组合构造动态路径
如果目标是动态拼接后端请求路径（而非主机），可用 rewrite 提前改写 $request_uri，再交由 proxy_pass 转发。这种方式适用于路径规则明确、可正则提取的场景。
- rewrite 必须加 break，防止继续匹配其他 location
- proxy_pass 末尾不带路径，确保 rewrite 后的完整 URI 被传递
- 避免在 if 块里用 proxy_pass（Nginx 明确不推荐）
示例：把 /v2/{service}/xxx → 转发到 http://$service.internal:8080/xxx
location ~ ^/v2/(?<svc>[a-z]+)(?
rewrite ^/v2/[^/]+(.*)$ $1 break;
proxy_pass http://$svc.internal:8080;
}
注意事项与避坑点
有些看似合理写法实际无效，务必避开：
- proxy_pass http://$host:$port/api —— URI 部分含变量，启动即失败
- resolver 在 http 块，set 和 proxy_pass 在 location —— 低版本 Nginx 不识别，DNS 不刷新
- set $url "https://api.com"; proxy_pass $url —— 协议不能塞进变量，会触发 500 或连接异常
-
location 正则匹配时 proxy_pass 带路径 —— 如
location ~ /api/ { proxy_pass http://b.com/v1/; }，Nginx 直接拒绝加载
