13.8.4 后端连接复用与队列管理（http-reuse、maxqueue）

后端连接复用与队列管理用于在高并发下减少后端建连开销、平滑突发流量并避免后端瞬时过载。HAProxy 通过 http-reuse 复用后端连接，并以 maxqueue + timeout queue 控制排队长度与时延。

1. 原理草图（连接复用与队列）

flowchart LR
  C[Client] --> F[Frontend]
  F -->|keep-alive| H[HAProxy]
  H -->|http-reuse| B1[Backend1]
  H -->|http-reuse| B2[Backend2]
  H --> Q[Queue<br/>maxqueue/timeout queue]
  Q --> B1
  Q --> B2

2. http-reuse 模式与适用场景
- never：不复用，行为清晰但性能较低。
- safe：仅在可安全共享时复用，通用业务推荐。
- aggressive：尽量复用，适合后端支持长连接且无强隔离需求。
- always：无条件复用，需确认后端协议与应用兼容。

3. 完整配置示例（含参数解释）
文件：/etc/haproxy/haproxy.cfg

global
  log /dev/log local0
  maxconn 50000

defaults
  mode http
  option httplog
  option http-keep-alive
  timeout connect 3s
  timeout client 30s
  timeout server 30s
  timeout queue 5s

frontend fe_http
  bind *:80
  default_backend app_backend

backend app_backend
  balance roundrobin
  http-reuse safe
  maxqueue 2000
  server app1 10.0.0.11:8080 maxconn 200 check
  server app2 10.0.0.12:8080 maxconn 200 check

option http-keep-alive：允许与后端保持可复用连接。
http-reuse safe：安全复用，降低建连成本。
maxqueue 2000：排队上限，超过返回 503。
timeout queue 5s：排队最大等待时间。
server maxconn：限制单实例并发，避免被打满。

4. 安装与加载配置（可执行示例）

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install -y haproxy

# RHEL/CentOS
sudo yum install -y haproxy

# 配置检测与热重载
sudo haproxy -c -f /etc/haproxy/haproxy.cfg
sudo systemctl reload haproxy

-c：校验配置语法。
reload：平滑加载，避免中断连接。

5. 验证与观测（命令 + 预期效果）
启用 stats（可选）：

listen stats
  bind *:8404
  stats enable
  stats uri /stats
  stats refresh 5s

访问 http://<haproxy-ip>:8404/stats 查看：
- qcur/qmax：当前/最大队列长度
- scur/smax：后端连接使用情况
- srv_abrt/rq_abrt：中断请求数

压测对比：

# 需要安装 hey 或 wrk
hey -z 30s -c 200 http://<haproxy-ip>/

预期：开启 http-reuse 后后端连接数增长变慢，平均延迟下降；maxqueue 过小会导致 503 增多。

6. 排错清单（含命令）
- 复用后业务异常：
- 现象：响应串线、会话错乱
- 处理：将 http-reuse 降为 safe/never，确认后端是否支持连接复用
- 队列过长导致超时：
- 现象：rq_abrt 增大、客户端超时
- 处理：降低 maxqueue 或缩短 timeout queue
- 后端连接暴涨：
- 检查：
grep -E "http-reuse|http-keep-alive" /etc/haproxy/haproxy.cfg ss -ant | grep ':8080' | wc -l
- 处理：确认后端是否关闭 keep-alive、是否存在短连接应用层策略

7. 练习（动手验证）
1) 将 http-reuse 从 safe 改为 never，压测对比后端连接数变化。
2) 将 maxqueue 设为 50，观察 503 与 qcur/qmax 指标变化。
3) 保持 maxqueue 2000，将 timeout queue 1s，对比平均延迟与中断请求数。