proxy_pass本身不支持动态调整后端权重，权重由upstream块中server指令的weight参数定义；动态调整需通过reload配置、nginx plus api、lua脚本等方式实现，且仅在加权轮询等兼容算法下生效。
proxy_pass 本身不支持动态调整后端服务器权重，它只是定义请求转发的目标地址。真正的权重控制在 upstream 块中完成，而 upstream 的权重是静态配置项。要实现“动态调整代理权重”，关键不是改 proxy_pass，而是通过其他机制实时更新 upstream 配置并重载生效，或借助外部模块绕过 reload。
通过 upstream + 权重参数实现基础调度
权重写在 upstream 定义里，不是 proxy_pass 指令中：
- proxy_pass http://backend; 只负责把请求发给名为 backend 的 upstream 组
- 权重由 upstream 内部 server 指令的 weight 参数决定，例如：
upstream backend {
server 192.168.1.10:8080 weight=3;
server 192.168.1.11:8080 weight=1;
} - weight 默认为 1；数值越大，该节点在加权轮询（WRR）中被选中的概率越高
动态修改权重的可行方式
NGINX 开源版原生不提供运行时 API 修改 upstream 权重，但可通过以下路径间接实现：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
- 配置文件热更新：修改 upstream 中的 weight 值 → 执行 nginx -s reload。这是最常用、最稳妥的方式，reload 几乎不中断服务
- 使用 nginx-upstream-check-module + 动态健康检查：配合状态页和脚本，自动剔除异常节点（相当于临时 weight=0），间接影响实际流量分配
- 接入 Nginx Plus 或商业版：提供 /api/5/upstreams/{upstream_name}/servers 接口，支持 PATCH 修改 weight、max_conns 等参数，无需 reload
- 用 Lua + balancer_by_lua*（OpenResty）：在请求阶段用 Lua 脚本计算目标 server，完全绕过 upstream 权重机制，实现基于响应时间、自定义标签等逻辑的动态路由
注意权重生效的前提条件
权重只在特定负载均衡算法下起作用：
- 默认轮询（round-robin）不看 weight，所有节点均等分配
- 必须显式启用 weighted round-robin，即不加其它调度指令时，weight 才有效
- 若配置了 least_conn、ip_hash、hash $arg_id 等其它调度方式，weight 将被忽略（least_conn 除外，它可与 weight 共存）
- 健康检查失败的节点会被临时摘除，此时剩余节点按其 weight 重新归一化参与调度
避免常见误区
有些做法看似“动态”，实则无效或危险：
- 试图在 location 块里用变量拼接 proxy_pass 地址（如 proxy_pass http://$backend_url）→ 无法携带 weight，且会禁用连接池，严重降低性能
- 频繁 reload 配置 → 虽然轻量，但每秒多次 reload 可能引发 worker 进程抖动，不建议用于毫秒级调控
- 认为 weight 是精确比例 → 实际是概率倾向，小流量下可能偏差明显；大流量（数百请求以上）才趋近理论值
