Nginx代理层通过Map指令实现动态负载均衡-Nginx-PHP中文网

Nginx可通过map指令结合proxy_pass实现动态路由：在http块中用map基于请求参数、头、IP等映射目标后端变量，location中proxy_pass引用该变量；支持正则和默认值，但无健康检查与权重。

nginx代理层通过map指令实现动态负载均衡

单纯用 Nginx 的 upstream 做静态负载均衡很常见，但若想根据请求头、参数、IP 或路径等动态决定转发到哪个后端，仅靠 upstream 和 proxy_pass 是不够的。Nginx 本身不原生支持运行时计算后端地址，但可以通过 map 指令 + 变量 + proxy_pass 动态拼接的方式，实现轻量、声明式的“动态负载均衡”逻辑。

用 map 提取决策依据并映射目标后端

map 是 Nginx 的变量映射模块（需启用 ngx_http_map_module，通常默认开启），它能基于任意已知变量（如 $arg_env、$http_x_version、$remote_addr）生成新变量。这个新变量可作为 proxy_pass 的 host 部分，从而实现路由分发。

例如，按请求参数 env=prod 或 env=test 分流：

map $arg_env $backend_host {
    default     "10.0.1.10:8080";
    "prod"      "10.0.2.100:8080";
    "test"      "10.0.2.101:8080";
    "~^staging.*$"  "10.0.2.102:8080";
}

注意：map 块必须写在 http 块中；支持字符串匹配、正则（用 ~ 开头）、通配和默认值；映射结果是纯字符串，不执行 DNS 解析或健康检查。

在 location 中动态 proxy_pass 到 map 变量

有了 $backend_host，就可以在 location 里直接使用它构造 proxy_pass：

location /api/ {
    proxy_pass http://$backend_host;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}

⚠️ 关键限制：Nginx 要求 proxy_pass 后不能带 URI 路径（如 http://$backend_host/），否则会丢弃原始请求路径。正确写法是末尾不加 /，且确保后端能正确处理原始 URI。若需重写路径，应配合 rewrite 或 proxy_redirect 使用。

结合 resolver 实现基于域名的动态上游（进阶）

如果后端地址是域名（如 svc-prod.mycluster.local），而该域名会动态变更（如 K8s Service DNS），则需启用 DNS 解析：

在 http 块中配置 resolver（如 resolver 10.96.0.10 valid=30s;）
map 中仍可映射为域名字符串，如 "prod" "svc-prod.mycluster.local:8080"
proxy_pass http://$backend_host 会自动触发 DNS 查询（受 resolver 和 valid 控制）

这种方式适合云原生环境，但要注意：DNS 缓存周期、解析失败时的行为（Nginx 默认会 502）、以及无法做连接池复用或健康探测——这些需由上层服务发现机制补足。

注意事项与替代建议

这种方案本质是“动态路由”，不是传统意义的“负载均衡”（无权重、无健康检查、无会话保持）。实际使用中需注意：

不支持对同一 map 目标做轮询或 IP hash；如需真负载，应在 $backend_host 映射为一个 upstream 名称，再定义该 upstream 内部的多台机器
所有逻辑都在配置中，上线需 reload；高频变更场景建议用 OpenResty + Lua 或专用 API 网关（如 Kong、Traefik）
调试时可用 add_header X-Backend $backend_host; 查看实际路由结果