Nginx搭配HAProxy时HTTP/2 Push功能失效问题求助

我之前在部署类似架构时也碰到过这个问题，核心原因通常是HAProxy的TCP转发配置细节或者Nginx对明文HTTP/2的支持配置没做好，下面一步步帮你排查和解决：

1. 确认HAProxy的流量转发模式与后端配置 #

你的HAProxy frontend用了mode tcp，这意味着它应该完全透传TCP流量，不能有任何HTTP层的处理逻辑。请检查你的app-http2 backend配置：

• 确保backend没有启用mode http，必须保持mode tcp（如果没显式设置，默认和frontend一致是tcp，但最好显式声明）
• 移除所有HTTP相关的配置指令，比如option httpchk、http-request、http-response等。如果需要健康检查，改用TCP层的检查：

  backend app-http2
    mode tcp
    option tcp-check
    tcp-check connect
    tcp-check send GET /health HTTP/1.1\r\nHost: example.com\r\n\r\n
    tcp-check expect string 200 OK
    server nginx1 192.168.1.100:8080 check
  

• 确认backend的server端口指向Nginx的明文HTTP/2监听端口（不是SSL端口，因为HAProxy已经在frontend终止了SSL）

2. 修正Nginx的HTTP/2监听配置 #

因为HAProxy已经终止了SSL，转发给Nginx的是明文HTTP/2流量，而Nginx默认只在SSL端口自动启用HTTP/2，明文端口需要显式指定http2参数：

server {
  # 监听HAProxy转发过来的明文端口，比如8080
  listen 8080 http2;

  server_name your-domain.com;

  # 保留你的HTTP/2 Push配置，比如：
  location / {
    root /usr/share/nginx/html;
    index index.html;
    http2_push /css/main.css;
    http2_push /js/app.js;
  }
}

如果你的Nginx之前是监听443端口的SSL+HTTP/2，直接访问时没问题，但HAProxy转发的明文流量到这个端口的话，Nginx会把它当作HTTP/1.1处理，自然不会触发Push。

3. 验证HAProxy的HTTP/2支持与ALPN协商 #

• 执行haproxy -v，确认输出中包含HTTP/2字样，说明编译时启用了HTTP/2支持
• 确认frontend的ALPN配置正确：alpn h2,http/1.1，这个配置会优先和客户端协商HTTP/2
• 可以用curl测试ALPN协商结果：

  curl -v --http2 https://your-domain.com
  

  输出中如果看到ALPN, server accepted to use h2，说明HAProxy和客户端的HTTP/2协商正常

4. 检查流量是否被篡改 #

如果以上配置都正确，还可以用抓包工具（比如tcpdump）在Nginx服务器上抓包，查看收到的流量是否是完整的HTTP/2帧。如果抓包显示Nginx收到的是HTTP/1.1请求，那说明HAProxy的backend分流逻辑有问题，比如use_backend app-http2的条件没触发。

你可以在HAProxy的frontend添加日志，确认ALPN协商结果：

frontend appname
  bind *:443 ssl crt certificate.pem alpn h2,http/1.1
  mode tcp
  log global
  capture request header Host len 64
  capture request header X-Forwarded-For len 15
  # 记录ALPN协商结果到日志
  http-request set-header X-ALPN %[ssl_fc_alpn]
  use_backend app-http2 if { ssl_fc_alpn -i h2 }
  default_backend app-http1

然后查看HAProxy的日志，确认当客户端用HTTP/2访问时，是否正确转发到了app-http2 backend。

内容的提问来源于stack exchange，提问作者Roel van Duijnhoven