nginx 1.24.x/1.25.x 不支持 http/2 server push,因 http2_push 指令已在 1.13.9 中被官方移除;推荐改用 link 响应头实现 preload。

当前稳定版 Nginx(1.24.x / 1.25.x)**不支持 HTTP/2 Server Push**,http2_push 指令已在 1.13.9 版本中被官方移除,配置了也不会生效——这不是你配错了,是它根本不存在。
确认 Nginx 是否真支持 http2_push(大概率不支持)
很多人在配置里写了 http2_push /style.css; 却没效果,第一反应是“证书没配对”或“listen 少了 http2”,其实根源更简单:这个指令压根不被识别。
- 运行
nginx -V 2>&1 | grep -o http2_push—— 输出为空就说明编译时没包含(也根本不可能有,因为已移除) -
nginx -t不会报错,但 reload 后查nginx -T会发现该行被静默跳过 - Chrome DevTools Network 面板里永远看不到 “push” 类型请求,Initiator 列也不会出现 push 字样
为什么官方删了 http2_push?
不是技术做不到,而是实践证明它副作用大于收益:
- 浏览器(Chrome 96+、Firefox 97+)已默认禁用 Server Push,ALPN 协商时即使服务端通告
h2,也不再响应 PUSH_PROMISE 帧 - 推送无法感知客户端缓存状态:用户本地已有
/app.js,你还推一遍,纯属浪费带宽 - 推送阻塞关键资源:一个大图的 push 可能延迟 HTML 的解析和渲染,反而拖慢首屏
- Nginx 作为反向代理/静态服务器,缺乏应用层语义,根本不知道“该推什么、何时推”
替代方案:用 Link 响应头做 preload(推荐且有效)
真正可控、标准、广泛支持的方式是让后端生成 Link 响应头,Nginx 默认透传,浏览器按需预加载:
- PHP 示例:
header('Link: ; rel=preload; as=style, ; rel=preload; as=script'); - Node.js(Express):
res.append('Link', '; rel=preload; as=style'); - Nginx 不需要额外配置,只要不拦截
Link头(默认不拦截) - 验证方式:DevTools → Network → 点开任意请求 → Response Headers → 查找
link:字段
容易被忽略的细节
即使你坚持用旧版 Nginx(≤1.13.8)并编译了 http2_push,以下几点仍会直接导致失效:
- 推送路径必须是绝对路径,
http2_push style.css;或http2_push /static/css/app.css?v=1;都会被丢弃 - 只对 Nginx 直接返回的静态文件生效;若走
proxy_pass或fastcgi_pass,推送逻辑不触发 - 若推送的资源返回 404 或 500,Nginx 仍发 PUSH_PROMISE 帧,但浏览器丢弃——白占连接流控额度
-
http2_max_concurrent_streams默认 128,首页推 5 个资源没问题,但高并发下可能被限流,需实测调整
别花时间调试一个早已废弃的功能。把精力放在 Link 头、资源内联、HTTP/2 连接复用和 TLS 1.3 优化上,才是当前真实有效的加速路径。











