Apache HTTP Server 怎么配置主动健康检查探测后端节点状态-Apache-PHP中文网

apache主动健康检查需启用mod_proxy_hcheck模块并配合balancer://集群，通过proxyhcexpr定义响应体/头校验表达式，为每个balancermember配置hcexpr、hcuri等参数，确保后端返回业务预期内容而非仅连通性。

apache 要实现主动健康检查，核心是启用 mod_proxy_hcheck 模块，并配合 balancer:// 结构使用表达式判断响应内容。它不是只看“连得上”，而是验证后端是否真正能返回符合业务预期的响应。

四个前提缺一不可：

Apache 版本 ≥ 2.4.33（推荐 2.4.47+），运行 httpd -M | grep proxy_hcheck 确认模块已加载；未出现则需手动添加 LoadModule proxy_hcheck_module modules/mod_proxy_hcheck.so
必须用 balancer:// 定义后端集群，ProxyPass 必须指向类似 balancer://myapp 的地址，不能直接写 http://10.0.1.10:8080
每个后端节点必须作为 BalancerMember 显式声明，且带 hcexpr=xxx 参数绑定校验逻辑
mod_proxy 和 mod_proxy_http 必须已启用（否则代理本身就不工作）

仅靠状态码 200 不够，要解析响应体或响应头：

Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。

下载

用 ProxyHCExpr 写表达式，例如：
ProxyHCExpr app_ok {%{hc resp body} =~ /"status"\s*:\s*"UP"/ && %{hc resp body} =~ /"cache"\s*:\s*"ready"/}
如果后端在响应头中返回 X-Health-Status: ready，可写：
ProxyHCExpr header_ok {%{hc resp header X-Health-Status} == "ready"}
避免用 %{REQUEST_STATUS}——那是请求 Apache 自身的状态，不是后端响应状态

不同服务可用性要求不同，可差异化配置：

在 <proxy balancer:></proxy> 块内逐行设置：
BalancerMember https://10.0.1.10:8443/ hcexpr=app_ok hcuri=/healthz hcinterval=10 hctimeout=3
BalancerMember https://10.0.1.11:8443/ hcexpr=header_ok hcuri=/health/db hcinterval=5 hctimeout=2
hcuri 指向真实健康端点（建议由后端提供，验证数据库、缓存等依赖）
节点连续失败后自动标记为 DOWN，后续请求不再路由过去；下一次探测成功即恢复

配完不验证等于没配：

开启详细日志：LogLevel proxy_hcheck:trace8，重启后查 error_log 是否有 hcheck: running health check 记录
访问 http://your-apache/server-status?auto，确认各节点显示 State: Ok 或 State: Down，而非一直卡在 Init
临时停掉一个后端，观察日志是否触发 DOWN 事件，再启起来看是否自动恢复