Nginx中proxy_pass支持变量动态代理，但变量只能包含协议、主机和端口（如http://host:port），不可含URI路径；否则报错。URI由Nginx自动追加，路径改写需用rewrite配合无路径的proxy_pass。
在 Nginx 中，proxy_pass 支持使用变量实现动态代理，但有明确限制：**不能在变量中包含 URI 路径部分（即不能带斜杠 / 开头的路径）**，否则会报错 "proxy_pass cannot have URI part in location given by regular expression" 或类似提示。
必须用变量拼接完整后端地址（不含 URI）
当需要根据请求头、域名、路径等动态选择上游服务时，应把协议、主机、端口拼成完整 URL，且 不带路径。Nginx 会自动将原始请求的 URI 追加过去。
- ✅ 正确写法（变量只含 host:port 或 scheme://host:port）：
set $backend "http://192.168.1.10:8080";
proxy_pass $backend;
}
- ❌ 错误写法（变量含路径，如
"http://.../v1"）：
proxy_pass $backend;
常见动态场景与写法示例
利用 $host、$arg_*、$http_x_* 等变量做路由判断，再 set 后端地址。
-
按 Host 头分发到不同集群：
if ($host ~ "^app1\.example\.com$") {
set $upstream "http://10.0.1.100:3000";
}
if ($host ~ "^app2\.example\.com$") {
set $upstream "http://10.0.1.101:3000";
}
proxy_pass $upstream; -
按请求参数选后端（如灰度）：
set $upstream "http://default-backend:8080";
if ($arg_env = "staging") {
set $upstream "http://staging-backend:8080";
}
proxy_pass $upstream; -
结合 map 指令更安全高效（推荐替代 if）：
map $host $backend {
default "http://10.0.1.200:8080";
app1.example.com "http://10.0.1.100:8080";
app2.example.com "http://10.0.1.101:8080";
}
server {
location / {
proxy_pass $backend;
}
}
注意 URI 重写与变量代理的配合
如果需要修改转发路径（比如去掉前缀），不能靠变量拼路径，而要用 rewrite + proxy_pass 不带路径的形式。
- 例如把
/api/v1/xxx转给http://backend/xxx：
location ^~ /api/v1/ {
rewrite ^/api/v1/(.*)$ /$1 break;
proxy_pass http://backend; } - 若用了变量，也必须保持无路径：
set $backend "http://backend";
rewrite ^/api/v1/(.*)$ /$1 break;
proxy_pass $backend;
限制与避坑提醒
动态 proxy_pass 是强大功能，但要注意：
- if 指令在 location 外无效，所有 set 必须在能生效的作用域内（通常在 location 或 server 块中）；
- 变量内容不能含空格或特殊字符，否则解析失败，建议用 map 或严格校验；
-
HTTPS 后端需开启
proxy_ssl_*相关配置，否则连接被拒绝； -
不支持在 proxy_pass 中直接嵌套复杂表达式，如
proxy_pass http://$host:$arg_port可能因端口为空导致错误，需先判断默认值。
