nginx 实现 java 服务动态负载均衡需通过 consul 构建“注册→检查→同步→生效”闭环：java 服务带健康检查注册至 consul，nginx 通过 consul-template、nginx-upsync-module 或 nginx plus dns srv 同步节点，配合平滑上线与故障自愈机制。
Nginx 本身不支持动态服务发现，Java 应用也无法直接让 Nginx “感知”自己上线或下线。要实现 Java 服务 + Nginx + Consul 的动态负载均衡，核心是构建一条“注册→检查→同步→生效”的闭环，而不是靠 Nginx 主动拉取或 Java 主动通知。
Java 服务向 Consul 注册要带健康检查
Spring Boot 项目推荐用 spring-cloud-starter-consul-discovery（适配 Consul 1.14+ 推荐用 spring-cloud-starter-consul-config + 手动注册）。关键点：
- 启动时自动注册服务 ID、IP、端口、标签（如
env=prod、version=2.5） - 必须配置 HTTP 健康检查路径（如
/actuator/health），返回 200 且响应时间 ≤ 2s - Consul Agent 部署在 Java 服务同机，避免网络抖动导致误判；检查间隔设为
5s，超时设为1s - 注册后，在 Consul UI 或
curl http://localhost:8500/v1/health/service/my-java-app?passing能看到状态为passing才算真正就绪
Nginx 获取节点列表的三种可靠方式
根据业务规模和 SLA 要求选一种，不建议混用：
-
consul-template（入门首选）：监听
service "my-java-app" with passing status，渲染出带max_fails=2 fail_timeout=30s的 upstream 块，再执行nginx -t && nginx -s reload。reload 是原子操作，毫秒级完成，但每分钟变更不宜超过 5 次 -
nginx-upsync-module（高并发推荐）：需重新编译 Nginx，模块直连 Consul HTTP API（如
http://127.0.0.1:8500/v1/health/service/my-java-app?passing），节点信息存入共享内存，worker 进程实时读取，完全免 reload -
NGINX Plus DNS SRV（企业版）：配置
resolver 127.0.0.1 valid=5s;+server service.my-java-app.service.consul resolve;，依赖 Consul 内置 DNS，适合已有 NGINX Plus 许可的团队
Java 上线/扩容时的平滑接管要点
新实例注册 ≠ 立即接收流量，必须分两步控制：
- Consul 层：注册时设置
"initial_status": "critical"，等健康检查连续通过 3 次后再自动切为passing，防止冷启动失败被立刻转发请求 - Nginx 层：配合
proxy_next_upstream error timeout http_502 http_503，当某台 Java 实例刚启动未就绪，Nginx 自动重试其他节点，用户无感 - 若用 upsync-module，还可配置
upsync_lb fair或upsync_lb least_conn，比默认轮询更适应 Java 应用启动耗时差异
验证与日常巡检建议
上线后不是一劳永逸，需建立轻量监控习惯：
- 查 Consul：确认服务数量、状态、Tag 是否一致：
consul catalog services | grep java，consul health service my-java-app - 查 Nginx：看生成的 upstream 文件是否含最新 IP，或用
upstream_show（upsync 模块提供）查看运行时节点列表 - 模拟故障：手动停掉一台 Java 实例，观察 Consul 状态是否在 10 秒内变
critical，Nginx 是否在 2–5 秒内剔除该节点（consul-template 方式含 reload 延迟）
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
