在 apache http server 中,`proxypass` 指令本身并不直接提供类似“重试 n 次”的显式配置参数。要实现故障后的自动重试,必须结合 `mod_proxy_balancer`(负载均衡模块)或 `mod_cache`(缓存模块),利用负载均衡器的 `retry` 属性或缓存的回源机制来实现。最标准且推荐的做法是使用 `balancer://` 协议,并在 `balancermember` 中设置 `retry` 参数,这样当后端服务器返回错误(如 503 service unavailable)时,apache 会自动将请求转发给集群中的其他健康节点。

使用 BalancerMember retry 参数实现后端故障转移
通过配置 `mod_proxy_balancer`,可以在 `BalancerMember` 指令中指定 `retry` 时间间隔。当某个后端节点不可用或返回特定错误码时,Apache 会等待设定的秒数后再次尝试该节点,或者立即尝试其他节点(取决于负载均衡算法和配置)。这是处理单点故障或临时过载的最有效方式。

<virtualhost>
ServerName example.com
ProxyPreserveHost On
<proxy>
BalancerMember http://backend1:8080 retry=60
BalancerMember http://backend2:8080 retry=60
ProxySet lbmethod=byrequests
</proxy>
ProxyPass "/" "balancer://mycluster/"
ProxyPassReverse "/" "balancer://mycluster/"
</virtualhost>
在上述配置中,`retry=60` 表示如果 `backend1` 失败,Apache 将在 60 秒内暂时将其标记为不可用,期间所有新请求将被分配给 `backend2`。60 秒后,Apache 会尝试向 `backend1` 发送一个探测请求,如果成功,则重新将其加入可用池。这种机制确保了在单个后端重启或短暂宕机时,服务不会中断。
利用 mod_cache 实现静态内容回源重试
对于静态资源或可缓存的内容,可以使用 `mod_cache` 配合 `mod_disk_cache` 或 `mod_mem_cache`。当缓存未命中(Cache Miss)且后端返回错误时,可以通过配置 `CacheQuickHandler` 和相关的错误处理指令来间接实现重试逻辑,或者更常见的是,依赖负载均衡器在前端拦截错误并触发重试。然而,若需针对单一后端进行简单的重试,通常还是回归到 `mod_proxy_balancer` 的 `retry` 机制。另一种场景是,如果后端返回 404 或 500,而你有备用源,可以结合 `ErrorDocument` 和 `RewriteRule` 进行复杂的重定向,但这不属于标准的透明重试。因此,对于大多数动态应用,坚持使用 `BalancerMember` 的 `retry` 是最稳妥的方案。
通过Apache Tika Server REST API从1400多种文件格式中提取文本和元数据。处理PDF、DOCX、PPTX、电子邮件归档以及带有MIME类型检测的嵌入式文档提取。

<virtualhost>
ServerName static.example.com
ProxyPreserveHost On
<proxy>
BalancerMember http://origin1:80 retry=30
BalancerMember http://origin2:80 retry=30
ProxySet lbmethod=bytraffic
</proxy>
ProxyPass "/images" "balancer://staticcluster/images"
ProxyPassReverse "/images" "balancer://staticcluster/images"
# 可选:启用缓存以减少对后端的压力
CacheEnable disk /images/
CacheRoot /var/cache/apache2/mod_cache_disk
</virtualhost>
此配置展示了如何在静态资源代理中应用相同的重试逻辑。`lbmethod=bytraffic` 根据流量大小分配请求,而 `retry=30` 确保在任一源站故障时,流量能在 30 秒内平滑迁移至另一源站。结合 `mod_cache`,即使后端短暂不可用,用户也能从缓存中获取旧版内容,提升用户体验。注意,`retry` 参数仅在后端明确返回错误或连接超时时生效,不会用于正常的业务逻辑错误(如 400 Bad Request)。
retry 参数在不同后端响应下的具体行为验证
在实际部署中,`retry` 参数的行为高度依赖于后端返回的 HTTP 状态码。Apache 的 `mod_proxy_balancer` 默认只对 503 Service Unavailable 和连接超时触发重试机制。如果后端返回 500 Internal Server Error,默认情况下 Apache 可能会将该节点标记为错误,但是否触发 `retry` 计时器取决于具体的负载均衡算法和版本实现。在某些配置下,连续的 500 错误也可能导致节点被暂时剔除。为了验证这一点,我们可以观察当后端故意返回 500 时,Apache 是否会将后续请求路由到其他健康的 `BalancerMember`。如果希望更精细地控制哪些错误码触发重试,可能需要借助 `mod_rewrite` 或外部脚本,但标准的 `retry` 参数主要服务于高可用性场景下的临时故障恢复,而非业务逻辑错误的重试。










