HAProxy 2.6 http-check 配置怎么改？旧版本该怎么迁移？

HAProxy 2.6 版本废弃了 `option httpchk` 指令，迁移需改用 `http-check send` 定义请求，并用 `http-check expect` 定义期望状态。旧版本配置直接升级会导致健康检查失效，后端服务器可能被错误标记为下线。

先说结论：HAProxy 2.6 健康检查语法发生Breaking Change，必须手动修改配置才能维持服务可用性。

适合：从 HAProxy 2.4 及以下版本升级至 2.6 及以上版本的运维场景。
先准备：备份现有配置文件，并在测试环境验证新语法兼容性。
验收：确认后端服务器状态在 HAProxy Stats 页面显示为 UP，且日志无检查失败报错。

命令速用版

# 旧版本配置 (2.4 及以下)
backend web_servers
    option httpchk GET /health
    http-check expect status 200

# 2.6 新版本配置
backend web_servers
    http-check send meth GET uri /health
    http-check expect status 200

为什么会这样

HAProxy 2.6 重构了健康检查模块，将请求定义与检查选项分离。旧版 `option httpchk` 混合了请求方法和路径定义，新版 `http-check send` 提供了更细粒度的控制，支持更复杂的 Header 和 Body 定义。这一变更是为了统一配置逻辑，但导致旧配置无法直接兼容。

分步处理

步骤 1：备份当前配置
在执行任何更改前，复制当前运行的配置文件。

cp /etc/haproxy/haproxy.cfg /etc/haproxy/haproxy.cfg.bak_$(date +%F)

步骤 2：替换健康检查指令
查找所有包含 `option httpchk` 的行，将其替换为 `http-check send` 格式。如果旧配置包含 `http-check expect`，通常可以保留，但需确认语法细节。

# 查找命令
grep -n "option httpchk" /etc/haproxy/haproxy.cfg

# 编辑配置
vim /etc/haproxy/haproxy.cfg

步骤 3：检查配置语法
使用 HAProxy 自带的检查工具验证新配置是否合法，避免启动失败。

haproxy -c -f /etc/haproxy/haproxy.cfg

步骤 4：平滑重载服务
确认语法检查通过后，重载服务使配置生效，避免中断现有连接。

systemctl reload haproxy

怎么验证是否生效

检查后端状态
访问 HAProxy Stats 页面（通常配置在 8404 端口），查看后端服务器状态列是否显示为 UP。如果显示 DOWN 或 MAINT，说明健康检查未通过。

查看系统日志
检查系统日志中是否有健康检查失败的记录，确认没有频繁的上下线波动。

grep "health check" /var/log/syslog
# 或
journalctl -u haproxy -f

验证业务请求
通过负载均衡器 IP 访问实际业务接口，确认请求能正确转发到后端服务器，没有返回 503 Service Unavailable 错误。

常见坑

1. 忽略 Header 定义差异
旧版本中 `option httpchk` 有时隐式包含 Host 头，新版 `http-check send` 可能需要显式使用 `http-check send hdr` 定义 Host，否则后端应用可能拒绝请求。

2. 正则匹配失效
如果旧配置使用了 `http-check expect rstatus` 进行正则匹配，升级到 2.6 后需确认正则引擎兼容性，部分特殊字符可能需要转义。

3. 超时设置未迁移
健康检查超时参数 `inter`、`fall`、`rise` 通常挂在 server 行上，升级时容易遗漏，导致检查频率不符合预期。

常见问题

升级后所有后端都变 DOWN 了怎么办？

立即回滚到备份的旧配置文件并重启服务。检查新配置中 `http-check send` 的 URI 路径是否正确，以及后端应用是否要求特定的 Host 头。

HAProxy 2.6 还能用 option httpchk 吗？

不建议继续使用。虽然部分 2.6 小版本可能兼容，但该指令已被标记为废弃，后续版本会彻底移除，长期维护必须迁移到新语法。

如何定义带 Body 的健康检查？

使用 `http-check send body` 指令。例如：`http-check send meth POST uri /check body "{\"status\":\"ok\"}"`，注意 JSON 内容需要正确转义。

参考来源

HAProxy Official Documentation - Configuration Manual, Section on Health Checks. URL: https://docs.haproxy.org/
HAProxy Technology Blog - HAProxy 2.6 Release Highlights. URL: https://www.haproxy.com/blog/