Gin v1.9.1+Go1.21.2在CentOS8/Debian11上的服务器推送故障排查

核心原因：客户端对HTTP/2 Server Push的支持差异 #

你遇到的Failed to push: feature not supported错误来自Go标准库的HTTP/2实现，当客户端通过SETTINGS帧告知服务器禁用了Server Push功能（SETTINGS_ENABLE_PUSH=0）时，服务器尝试推送资源就会触发这个错误：

• Chrome：近年版本默认限制了Server Push的启用场景，部分情况下会主动发送禁用Push的SETTINGS帧；隐私模式、缓存策略或浏览器扩展也可能干扰Push功能。
• curl：低版本curl对HTTP/2 Server Push支持不完善，即使连接已建立HTTP/2，也会拒绝Push承诺；高版本curl需显式启用相关参数才能接受Push。
• Firefox、httpie、Postman：当前版本默认保留对Server Push的支持，会发送允许Push的SETTINGS帧，因此服务器推送可正常执行。

验证方法 #

1. 检查curl版本：执行curl --version，若版本低于7.64.0，对HTTP/2 Server Push的支持存在缺陷；高版本可尝试添加--http2-push always参数发起请求，观察是否仍报错。
2. 查看Chrome网络日志：打开开发者工具（F12）→ 网络面板→ 右键列头勾选「Protocol」和「Push」，发起请求后查看请求的协议类型及Push记录；也可在chrome://net-internals/#http2页面查看HTTP/2连接的SETTINGS参数。

解决方案 #

1. 兼容客户端行为：在代码中捕获Server Push的错误，避免影响主请求响应，示例代码：

   if err := c.Push("/static/css/main.css", nil); err != nil {
       // 仅记录错误，不中断主请求流程
       log.Printf("Push failed: %v", err)
   }
   

2. 调整客户端配置：
   • curl：升级至7.64.0及以上版本，测试时添加--http2-push always参数。
   • Chrome：在chrome://flags/#enable-http2-server-push中强制开启Server Push支持，或使用普通模式（非隐私模式）测试。
3. 确认版本兼容性：你使用的go1.21.2与gin v1.9.1版本组合完全兼容，Gin的Server Push实现直接依赖Go标准库的HTTP/2功能，无需额外适配。
4. 排查服务器配置：已通过HEAD请求验证HTTP/2连接正常，可确认TLS证书有效、Google Cloud负载均衡/防火墙及CentOS8的firewalld/selinux未拦截HTTP/2帧传输，此环节大概率无问题。

内容的提问来源于stack exchange，提问作者Naga Vijayapuram