mod_proxy_hcheck需显式启用并配置ProxyHCExpr和hcexpr才能基于响应内容判断健康状态，仅靠hcmethod和hcuri只能检查状态码，无法识别“假活”。

apache 的 mod_proxy_hcheck 是专为反向代理场景设计的主动健康检查模块，但它**默认不生效**——必须显式启用、正确定义表达式、并在后端节点中绑定使用，才能真正基于响应内容判断健康状态。仅靠 hcmethod=get 和 hcuri 是不够的，它只会看 http 状态码（2xx/3xx 就认为健康），而无法识别后端返回 200 ok 却含 {"alive":false} 这类“假活”情况。

确认前提：模块可用且版本达标

这是所有配置生效的基础：

• Apache 版本必须 ≥ 2.4.49（低版本不支持 %{hc resp body} 变量）
• 运行 httpd -M | grep proxy_hcheck，有输出说明模块已加载；若无，需在配置中添加：
  LoadModule proxy_hcheck_module modules/mod_proxy_hcheck.so
• 确保 mod_proxy、mod_proxy_balancer、mod_slotmem_shm 等依赖模块也已启用

定义健康判断逻辑：用 ProxyHCExpr 解析真实响应

不能只依赖状态码，要从响应体（或头）中提取业务语义。表达式名（如 ok）后续会在 BalancerMember 中通过 hcexpr= 引用，大小写必须严格一致：

FastAPI Flask Proxy

FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

下载

• 匹配 JSON 中 "status":"ok"（忽略空格）：
  ProxyHCExpr ok {%{hc resp body} =~ /"status"\s*:\s*"ok"/}
• 要求状态为 true 且不含维护标识：
  ProxyHCExpr ready {%{hc resp body} =~ /"ready"\s*:\s*true/ && %{hc resp body} !~ /"maintenance"/}
• 检查响应头（兼容旧版）：
  ProxyHCExpr healthy %{hc resp header X-Health} == "UP"

绑定到后端节点：在 BalancerMember 中启用检查

每个后端成员需显式指定探测方式和判断依据：

• hcmethod=GET：目前最常用，也支持 HEAD 或 TCP
• hcuri=/healthz：指向后端暴露的专用健康端点（推荐独立路径，避免与业务混用）
• hcexpr=ok：必须与上面 ProxyHCExpr 定义的名称完全一致
• 完整示例：
  BalancerMember http://10.0.1.10:8080 hcmethod=GET hcuri=/healthz hcexpr=ok hcinterval=10 hcfails=3 hcpasses=2

控制状态切换节奏：避免抖动误判

健康状态不是单次结果决定的，而是靠连续成功/失败次数触发：

• hcinterval=10：每 10 秒发起一次探测（建议 5–15 秒）
• hcfails=3：连续 3 次失败才标记为 Down（防网络瞬断）
• hcpasses=2：连续 2 次成功才恢复为 Up（防后端未完全就绪就导流）
• 注意：如果 hcexpr 始终不匹配（比如后端没返回预期字段），hcpasses 就不会累加，节点将卡在 Down 状态