HAProxy中LUA库通过Unix Socket发送请求时错误选择前端的问题分析

问题背景

在使用HAProxy的LUA脚本功能时，发现了一个关于HTTP客户端请求路由的异常行为。具体表现为：当通过Unix Socket发送HTTP请求时，连续发送的不同请求会被错误地路由到同一个前端服务，而实际上应该根据请求路径分发到不同的前端。

问题复现与现象

通过一个简单的测试用例可以复现该问题：

1. 配置两个前端服务（frontend1和frontend2），分别绑定到不同的Unix Socket路径
2. 主前端接收请求后，通过LUA脚本根据URL路径决定转发到哪个前端
3. 当快速连续发送两个请求（一个到"/1"，一个到"/2"）时，第二个请求会被错误地路由到第一个前端

值得注意的是，这个问题仅在通过Unix Socket通信时出现。如果改用IPv4地址进行通信，则行为正常。此外，如果调整客户端超时时间并增加请求间隔，也能暂时规避这个问题。

技术分析

根本原因

经过深入分析，发现问题的根源在于HAProxy的连接复用机制对于Unix Socket的处理存在缺陷。具体表现为：

1. 在conn_calculate_hash_sockaddr()函数中，对于非IPv4/IPv6的地址类型（如AF_UNIX）没有进行特殊处理
2. 导致不同Unix Socket路径的请求可能计算出相同的连接哈希值
3. 进而使得连接被错误地复用，请求被发送到错误的前端

影响范围

该问题影响所有支持LUA脚本和Unix Socket的HAProxy稳定版本，包括2.4.x至3.0.x系列。

解决方案

开发团队提出了两种解决方案：

1. 短期解决方案：在httpclient代理中显式禁用连接复用

px->options &= ~PR_O_REUSE_MASK;

2. 长期解决方案：完善conn_calculate_hash_sockaddr()函数中对Unix Socket的处理

case AF_UNIX:
    un = (struct sockaddr_un *)ss;
    conn_hash_update(hash,
                     &un->sun_path, sizeof(un->sun_path),
                     hash_flags, param_type_addr);
    break;

临时规避措施

在官方修复发布前，用户可以考虑以下临时解决方案：

1. 避免使用Unix Socket，改用IPv4/IPv6地址进行通信
2. 增加请求间隔时间，使其超过客户端超时设置
3. 在LUA脚本中实现额外的请求隔离机制

修复状态

该问题已在HAProxy的所有稳定版本中得到修复。用户升级到包含修复的版本后即可解决此问题。

总结

这个问题展示了在复杂网络代理系统中，连接复用机制对于不同地址类型处理的重要性。特别是对于Unix Socket这类特殊通信方式，需要特别注意其哈希计算和连接管理的特殊性。HAProxy开发团队的快速响应和全面修复体现了该项目对稳定性和兼容性的重视。