HAProxy 默认连接超时为 10 秒，但 2025 年 6 月 26 日记录的案例显示，配置 5 秒超时可能导致 RMI 接口在 5 秒钟被 HAProxy 主动关闭。
原因分析
连接超时报错的核心在于 TCP 握手阶段耗时超过了 HAProxy 设定的阈值。在 RMI 上线后的现网接口异常案例中，通过抓包发现失败的连接有个共同现象，就是在 5 秒钟被 HAProxy 主动关闭。这是因为 HAProxy 配置有个 connectTimeout 参数为 5 秒，当 HAProxy 连接后端的 RMI 服务器时，在 5 秒钟内并没有搜到从 HAProxy 发起的对后端的 SYN 报文，导致连接建立失败。此外，在 Kubernetes 集群场景中，若遇到"Unable to connect to the server: dial tcp 192.168.2.100:16443: connect: no route to host"报错，且端口号 16443 是 haproxy 的监听端口，则可能是路由不可达或服务可用性問題引发的超时。
解决方案
1. 调整超时参数配置
在配置文件的全局或 defaults 段修改超时时间。推荐实践是覆盖一个或者多个 TCP 包丢失，通过指定 timeouts 略高于 3 秒，比如 4 或者 5 秒。常见配置示例如下：
timeout connect 5000ms
timeout client 50000ms
timeout server 50000ms
时间单位可以使用 ms（毫秒）、s（秒）、m（分钟）等，例如 5000ms 等同于 5s。若业务查询数据量大，如 mycat 使用 HAProxy 高可用查询场景中，版本 HAPROXY 1.5 下 count(*) 返回 8kw 记录统计用时 2min+，需相应调大 timeout 值。
2. 验证配置文件语法
修改完成后，启动前使用命令验证配置文件语法，提前发现错误：
haproxy -c -f /etc/haproxy/haproxy.cfg
确保没有未知关键字错误，例如 maxqueue 和 weight 是用于定义后端服务器 (server 行) 的参数，而非 backend 全局段的参数，放错位置会导致语法解析失败。
3. 重启服务生效
配置验证无误后，重启 HAProxy 服务：
systemctl restart haproxy.service
若开启了 stats socket，可查看 haproxy.sock 文件是否存在以验证配置成功，例如路径/var/lib/haproxy/haproxy.sock。
注意事项
- 单位混淆风险：配置时需明确时间单位，us 为微秒，ms 为毫秒，s 为秒。未指定超时结果在一个无线的 timeout，这是不推荐的。
- 版本差异：不同版本行为可能不同，例如在定位问题时曾修改 HAProxy【1.4.23】源码添加自定义日志来跟踪会话行为。
- 参数位置：maxqueue 和 weight 等参数应直接附加在 server 行末尾，作为服务器级参数生效，放在 backend 段全局配置区域会导致启动失败。
- 网络环境：如果 server 是和 haproxy 在同一个 LAN 里，连接应该是立即的 (小于几毫秒)，若超时需检查防火墙或路由，如 K8s 中 kubeconfig 配置了错误的旧地址 192.168.2.100 而非有效 VIP。
参考来源
来源：51CTO 博客 - haproxy 超时时间修改 (2025 年 6 月 26 日)
来源：51CTO 博客 - haproxy 的配置和一些报错 (2019 年 11 月 12 日)
来源：51CTO 博客 - Kubernetes 集群连接故障排查 (2026 年 4 月 17 日)
来源：51CTO 博客 - HAProxy 启动失败深度解析 (2026 年 4 月 14 日)