怎么在Apache中配置ProxyPass的failonstatus指定触发故障隔离的状态码-Apache-PHP中文网

failonstatus是mod_proxy_balancer中用于被动健康检查的关键参数，通过匹配后端返回的500-599等错误状态码触发节点失效与冷却期；需在块中配合balancermember或proxyset配置，如failonstatus=500,502,503,504，并协同retry、timeout、maxattempts等参数生效。

怎么在apache中配置proxypass的failonstatus指定触发故障隔离的状态码

failonstatus 是 Apache mod_proxy_balancer 中用于被动健康检查的关键参数，它让 Apache 在收到后端返回的特定 HTTP 状态码时，立即将该节点标记为“失败”，从而触发故障隔离（如跳过该节点、启动 retry 冷却期等）。它不单独生效，必须配合 BalancerMember 或 ProxySet 使用。

failonstatus 的作用逻辑

它不是拦截或修改响应状态码，而是监听后端真实返回的状态码
一旦匹配，Apache 就认为这次请求“失败”，计入失败计数（受 hcfail 或被动失败策略影响）
连续失败达到阈值（如 hcfail=3 或默认被动失败机制）后，节点被标记为 down
同时触发 retry 倒计时：冷却期一过，自动重新参与负载

✅ 注意：failonstatus 只对 BalancerMember 生效，不能写在 ProxyPass 指令里；它也不适用于普通 ProxyPass http://...（非 balancer 地址）。

怎么配置 failonstatus

在 <proxy balancer:></proxy> 块中，为每个后端成员或整个 balancer 统一设置：

<proxy balancer:>
    BalancerMember http://192.168.1.10:8080 route=node1 failonstatus=500,502,503,504
    BalancerMember http://192.168.1.11:8080 route=node2 failonstatus=500,502,503,504
    ProxySet lbmethod=byrequests
</proxy>

ProxyPass / balancer://myapp/
ProxyPassReverse / balancer://myapp/

也可以统一设置到整个 balancer（推荐，避免重复）：

CPA Update - Secure CLI Proxy API Maintenance

安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。

下载

<proxy balancer:>
    BalancerMember http://192.168.1.10:8080 route=node1
    BalancerMember http://192.168.1.11:8080 route=node2
    ProxySet failonstatus=500,502,503,504
</proxy>

常用状态码建议

500：服务端内部错误（如 Java 应用崩溃、NPE）
502：网关错误（后端未响应、进程挂掉、反向代理链路断开）
503：服务不可用（常见于 Spring Boot 启动中、健康检查失败、限流熔断）
504：网关超时（后端响应慢，可能卡在 GC、DB 锁、网络抖动）

⚠️ 不建议加入 4xx（如 404、401），它们通常是业务正常反馈，不应导致节点下线。

配合使用的必要参数

retry=60：节点失败后 60 秒再尝试恢复（应对瞬时抖动）
timeout=5：单次请求最多等 5 秒，超时即算失败（配合 failonstatus 触发更快）
maxattempts=1：单个请求最多重试 1 次（防止雪崩式重试）
loadfactor=1：可结合权重，在部分节点异常时降低其流量占比

示例完整片段：

<proxy balancer:>
    BalancerMember http://10.0.1.10:8080 route=s1 loadfactor=2 timeout=5 retry=5
    BalancerMember http://10.0.1.11:8080 route=s2 loadfactor=2 timeout=5 retry=5
    ProxySet failonstatus=500,502,503,504 maxattempts=1
</proxy>

ProxyPass / balancer://myapp/
ProxyPassReverse / balancer://myapp/

验证是否生效

访问 /balancer-manager 页面，查看各节点状态、失败计数（Elected 和 Status 列）
手动让某台后端返回 503（如临时返回 curl -I -H "Host: example.com" http://192.168.1.10:8080/test 返回 503），观察其状态是否变为 down，并记录 Retry in ... sec
查看 Apache error log，搜索 proxy_balancer: worker 相关日志，确认是否打印 failed status 或 recovered

不复杂但容易忽略。