mod_proxy_hcheck通过为每个BalancerMember单独配置hcexpr等参数实现多后端混合健康检测：所有后端须注册于同一balancer://块，预定义ProxyHCExpr表达式，并在各BalancerMember中显式绑定hcmethod、hcuri、hcinterval和hcexpr。

apache 的 mod_proxy_hcheck 本身不支持“对多个后端统一用一套检测逻辑”，而是**为每个 balancermember 单独配置健康检查行为**——这恰恰是实现“多后端混合健康检测”的正确方式：不同协议、不同业务角色、不同响应语义的后端，就该用各自适配的探测策略。

一、必须共用 balancer:// 抽象层

所有待检测的后端节点，无论协议（HTTP/AJP/FCGI）或用途（下单/查询/文件处理），都必须注册在同一个 <Proxy balancer://xxx> 块中。只有这样，mod_proxy_hcheck 才会对其生效：

• http://10.0.1.10:3000 → Node.js API，用 /health 返回 JSON
• ajp://10.0.1.11:8009 → Tomcat，用 /actuator/health 返回 Spring Boot 格式
• fcgi://127.0.0.1:9000 → PHP-FPM，用 /ping 返回纯文本 pong

它们共享同一组负载策略（如 lbmethod=bybusyness），但健康检查参数可完全独立。

二、为每类后端定义专属健康表达式

用 ProxyHCExpr 预先声明多个判断逻辑，按需绑定到对应节点：

• JSON 接口检查：ProxyHCExpr node_ok {%{hc resp body} =~ /"status"\s*:\s*"UP"/}
• Spring Boot 检查：ProxyHCExpr spring_ok {%{hc resp body} =~ /"status"\s*:\s*"UP".*"diskSpace"/}
• 轻量 ping 检查：ProxyHCExpr php_ping {%{hc resp body} == "pong"}

注意：表达式必须放在 <IfModule proxy_hcheck_module> 块内或主配置顶部，且不能重名。

FastAPI Flask Proxy

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

下载

三、逐节点绑定检查参数

在每个 BalancerMember 行中，显式指定协议、路径、方法、间隔和表达式：

• BalancerMember http://10.0.1.10:3000 hcmethod=GET hcuri=/health hcinterval=10 hcexpr=node_ok
• BalancerMember ajp://10.0.1.11:8009 hcmethod=GET hcuri=/actuator/health hcinterval=15 hcexpr=spring_ok
• BalancerMember fcgi://127.0.0.1:9000 hcmethod=GET hcuri=/ping hcinterval=5 hcexpr=php_ping

关键点：hcexpr=xxx 不可省略——没它，前面定义的表达式不会被调用；hcuri 必须是后端真实暴露的端点，且返回内容能被对应表达式匹配。

四、验证与日志辅助

启用 trace8 级别日志（LogLevel proxy_hcheck:trace8），观察每条探测的实际请求、响应状态码、响应体及最终判定结果。典型日志片段如下：

[proxy_hcheck:trace8] [pid 12345] hc: member http://10.0.1.10:3000: status=200, body='{"status":"UP"}', expr=node_ok → OK
[proxy_hcheck:trace8] [pid 12345] hc: member ajp://10.0.1.11:8009: status=200, body='{"status":"DOWN"}', expr=spring_ok → FAIL

看到类似输出，说明混合检测已实际运行。