nginx原生不支持主动健康检查，需通过nginx_upstream_check_module实现url心跳检测；该模块需手动编译，兼容1.16–1.22版本，配置check指令可设置探测间隔、状态码判定等，并提供/status页面查看状态。
在 Nginx 原生负载均衡中，upstream 的健康检查默认是被动的（即仅在请求失败时标记节点不可用），不支持主动探测后端服务的 HTTP 状态。要实现主动式的 URL 心跳检测（比如定期 GET /health 并校验返回码或内容），需借助第三方模块 —— 最常用、维护活跃且生产验证充分的是 nginx_upstream_check_module。
确认并编译 nginx_upstream_check_module 模块
该模块非官方内置，需在编译 Nginx 时显式添加。注意：它只兼容较老的 Nginx 版本（如 1.16–1.22），对 1.23+ 支持有限；若使用较新版本，可考虑替代方案（如商业版 NGINX Plus 的主动健康检查，或用外部工具如 consul-template + health-checker 配合 Nginx reload）。
- 从 GitHub 获取源码：
https://github.com/yaoweibin/nginx_upstream_check_module - 打补丁（以 Nginx 1.20 为例）：
patch -p1 - 重新编译 Nginx，加入模块：
--add-module=/path/to/nginx_upstream_check_module - 验证是否加载成功：
nginx -V 2>&1 | grep -o check应有输出
配置主动心跳检测（HTTP 类型 check）
在 upstream 块中启用 check 指令，指定探测方式、路径、超时与判定逻辑：
-
check interval=3 rise=2 fall=3 timeout=1 type=http：每 3 秒探测一次，连续 2 次成功标记为 up，连续 3 次失败标记为 down，单次超时 1 秒 -
check_http_send "GET /health HTTP/1.0\r\n\r\n"：发送自定义 HTTP 请求（支持 Host 头等） -
check_http_expect_alive http_2xx http_3xx：只要响应状态码是 2xx 或 3xx 就认为健康（也可加http_4xx，但慎用） - 可选：用
check_shm_size 1M在全局 http 块设置共享内存大小，用于存储检查状态
示例配置片段：
upstream backend {server 192.168.1.10:8080;
server 192.168.1.11:8080;
check interval=3 rise=2 fall=3 timeout=1 type=http;
check_http_send "GET /health HTTP/1.0\r\nHost: example.com\r\n\r\n";
check_http_expect_alive http_2xx;
}
查看健康检查状态与调试技巧
该模块提供一个内置 status 页面（需配合 location 暴露）：
- 添加 location：
location /status { check_status; }（放在 server 块内） - 访问
http://your-nginx/status可看到每个 upstream server 的状态、失败次数、上次检查时间等 - 若探测失败，先 curl 后端
/health确认服务本身返回正常；再检查 Nginx 是否能连通该地址（防火墙、网络策略）、是否设置了正确的 Host 头 - 注意：该模块不校验响应 body 内容（如 JSON 中的
"status":"up"），如需内容级判断，需改用外部脚本 + API 触发 reload，或升级到支持match的商业版
替代方案：轻量级外部健康检查 + 动态配置
若无法编译定制模块（如使用系统包管理安装的 Nginx），可用外部进程实现类似效果：
- 用 Python/Shell 脚本定时请求所有后端
/health，生成动态 upstream 配置（只保留 healthy 节点） - 写入临时文件，通过
include /etc/nginx/conf.d/backend_dynamic.conf;引入 - 调用
nginx -s reload生效（注意 reload 频率不宜过高，避免抖动） - 工具推荐：
consul-template+consul服务发现，或nginx-upsync-module（支持 Consul/Etcd 动态更新 upstream）
