Apache本身不支持主备自动切换,mod_proxy_hcheck仅负责健康探测,主备行为依赖BalancerMember状态变化、负载均衡策略及外部干预。

Apache 本身不支持主备自动切换,mod_proxy_hcheck 也不是“主备控制器”,它只负责探测后端是否健康;真正的主备行为必须靠 BalancerMember 的状态变化 + 负载均衡策略(如 lbmethod=byrequests)+ 手动或脚本干预来体现。你不能指望 mod_proxy_hcheck 自己把流量从 A 切到 B 并保持 B 为“主”、A 为“备”——它只会把失败节点标记为 Down,然后请求自然落到其他可用成员上。
确认 Apache 版本与模块加载是否到位
低于 2.4.47 的 Apache 根本没有 mod_proxy_hcheck;即使版本达标,模块默认也不启用。
- 运行
httpd -V | grep SERVER_CONFIG_FILE确认配置路径,再查模块实际位置:httpd -M | grep proxy_hcheck—— 无输出即未加载 - 手动加载需在配置中加:
LoadModule proxy_hcheck_module modules/mod_proxy_hcheck.so,注意路径要和httpd -V输出的MODULES_DIRECTORY一致,别写成.c或漏.so - 该模块依赖
mod_watchdog,若启动报错Cannot load mod_proxy_hcheck.so,先检查mod_watchdog是否已启用
用 BalancerMember 参数绑定健康检查,而非独立启用
mod_proxy_hcheck 不是后台服务,它只在 ProxyPass 指向 balancer:// 时,对每个 BalancerMember 生效。所谓“主备”,本质是让一个节点长期 Up、另一个长期 Down,靠的是健康检查结果驱动状态变化。
- 主节点配健康检查,备节点不配(或配但故意返回失败),例如:
BalancerMember http://10.0.1.10:8080 hcmethod=GET hcuri=/health hcinterval=5 hcfails=1 hcpasses=1BalancerMember http://10.0.1.11:8080 status=+H(+H表示热备,不参与轮询,除非其他全Down) -
hcfails=1表示一次失败就标Down,适合主备场景快速摘除;但务必配合后端/health接口真实可靠,否则易误切 - 不要只依赖状态码:如果后端
/health总返回200但 body 是{"alive":false},必须加ProxyHCExpr解析响应体,例如:ProxyHCExpr alive {%{hc resp body} =~ /"alive"\s*:\s*true/},再在BalancerMember中引用hcexpr=alive
主备切换不是“一键切换”,而是状态收敛 + 请求路由重定向
当主节点被 mod_proxy_hcheck 标记为 Down 后,Apache 不会主动通知备节点“你现在是主了”,它只是停止向该节点转发新请求;所有流量自动流向仍为 Up 的成员——如果你只配了一个备节点且没设 status=+H,它就会立刻承接流量;如果用了 +H,则需等所有非热备节点都 Down 才触发。
- 验证当前状态:访问
/balancer-manager(需启用并授权),看各成员的State列是否实时更新为Down或Up - 故障恢复不是自动“回切”:主节点恢复后,需连续通过
hcpasses次检查才重新Up;若想避免自动回切(即维持备节点继续服务),可临时把主节点设为status=D(永久下线)或改其hcinterval为极大值 - 注意:所有
BalancerMember必须在同一<proxy></proxy>块内定义,跨虚拟主机或配置段会导致健康检查不生效
容易被忽略的关键点:健康接口本身必须稳定且低开销
很多人卡在“明明配了 hcuri=/health,但节点还是不 Down”,根本原因常出在健康接口上。
- Apache 进程得能稳定响应该路径:测试命令是
curl -sI http://127.0.0.1/health | head -1,返回HTTP/1.1 200 OK才算过关;若超时或返回503,检查是否被 SELinux 拦截(setsebool -P httpd_can_network_connect 1)或防火墙规则 - 别用
/server-status?auto做健康检查:它依赖mod_status,而该模块在高并发下可能阻塞,导致误判;推荐用静态文件(echo OK > /var/www/html/health)或极简 CGI -
hcinterval设太小(如1秒)会显著增加后端压力,尤其当后端是 Java 应用时,频繁健康请求可能触发 GC 或线程争用;建议生产环境不低于3秒,结合hcfails=2平衡灵敏度与稳定性


















