Nginx原生upstream不支持运行时动态调权，需通过配置重载、nginx-upstream-dynamic模块或Consul+consul-template三种方式实现；前者轻量但有秒级延迟，后两者分别支持毫秒级热更新和声明式自动同步。
在 Nginx 中，原生 upstream 模块不支持运行时动态修改服务器权重。所谓“动态调整”，实际需借助外部机制配合 Nginx 重载或使用扩展模块实现，而非直接通过 HTTP 接口实时变更内存中权重值。
基于配置文件 + reload 的轻量级动态方案
适用于中小规模、可接受秒级延迟的场景。核心思路是：外部程序生成更新后的 upstream 配置，触发 Nginx 重载。
- 将 upstream 块单独抽离到独立配置文件（如
upstream.conf），避免每次修改都动主配置 - 用脚本（Shell/Python）读取权重数据（来自 DB/API/文件），渲染生成新的
upstream.conf - 执行
nginx -t && nginx -s reload生效；注意 reload 是平滑重启，不影响已有连接 - 建议加锁机制防止并发写入冲突，同时记录操作日志便于追踪权重变更历史
使用 nginx-upstream-dynamic 模块（OpenResty 生态）
该第三方模块为 OpenResty 提供了真正的运行时权重热更新能力，通过 Lua 控制 upstream 节点状态与权重。
- 编译时启用
ngx_http_upstream_dynamic_module，或直接使用预编译 OpenResty 包 - 在 upstream 块中启用
dynamic指令，并配置后端管理接口（如 etcd 或本地 API） - 通过 HTTP 请求（如
PUT /upstream/myapp/server1）发送 JSON 更新权重：{"weight": 5} - 模块内部自动同步至共享内存，无需 reload，毫秒级生效，适合对一致性要求较高的服务
结合 Consul + nginx-consul-template 实现声明式权重管理
利用服务发现工具自动同步节点元信息（含权重），适合微服务环境。
- 在 Consul 中为每个服务实例注册时带上自定义标签，例如
"weight=3" - 使用
consul-template监听服务变化，按模板生成 Nginx upstream 配置（支持 weight 字段映射） - 模板示例：
server {{.Address}}:{{.Port}} weight={{.Tags.weight}} max_fails=2 fail_timeout=30s; - 模板更新后自动触发 reload，权重随服务注册状态实时联动，降低人工干预风险
注意事项与常见陷阱
无论采用哪种方式，都需关注以下细节：
- 权重仅在
least_conn和ip_hash外的轮询策略下生效；hash $request_uri等一致性哈希策略下权重影响有限 - Nginx 默认不校验 weight 合法性（如负数、超大值），需在上游生成逻辑中做范围约束（建议 1–100）
- reload 频繁会增加 worker 进程切换开销，生产环境建议限制单位时间 reload 次数（如 ≤2 次/分钟）
- 若使用 keepalive 连接池，权重变更后新请求立即生效，但已建立的长连接仍按旧权重路由，属正常行为
