nginx中正确配置http/2推送需满足四条件：启用http_v2_module模块、openssl≥1.0.2、listen 443 ssl http2、protocol显示h2；推送路径须为绝对路径且仅限静态文件响应；配合link头声明preload语义；验证须见devtools中initiator为push或nghttp输出push_promise。
要在 Nginx 中正确配置 HTTP/2 推送（Server Push）以提前加载关键静态资源，核心不是“开个开关就生效”，而是确保协议就绪、路径合规、顺序合理、验证到位。很多配置看似写对了却没推送，问题往往出在底层条件未满足或语义误用上。
确认 HTTP/2 基础环境已就绪
推送功能依赖真实运行的 HTTP/2 连接，不是仅靠配置就能触发：
- 运行
nginx -V 2>&1 | grep with-http_v2_module，输出必须含with-http_v2_module；若为空或报错，需重新编译安装并启用该模块 - 执行
nginx -V 2>&1 | grep -i openssl，OpenSSL 版本必须 ≥ 1.0.2（推荐 ≥ 1.1.1）；1.0.1e 或更低版本即使 Nginx 版本达标也无效 - 监听配置中必须带
http2参数，且仅作用于 HTTPS 端口：listen 443 ssl http2;；HTTP/2 不支持明文 HTTP - 浏览器 Network 面板中，目标请求的 Protocol 列必须显示
h2；若仍为http/1.1，说明 ALPN 协商失败，推送不会启动
使用 http2_push 精准推送关键资源
这是最直接的硬编码推送方式，适用于首页等固定路径场景，但有严格限制：
- 路径必须是绝对路径，以
/开头，如http2_push /style.css;；/style.css?v=1或style.css会被静默忽略 - 只对 Nginx 自身返回的响应生效（如
root或alias提供的静态文件）；若走proxy_pass或fastcgi_pass，推送不触发 - 按配置顺序推送：CSS 应排在图片之前，因为浏览器按接收顺序解析依赖；例如：
http2_push /main.css;<br>http2_push /logo.png;<br>http2_push /banner.jpg;
- 避免滥用：只推送 HTML 中明确引用的关键资源（如
<link rel="stylesheet">、内联<script></script>所需 JS），不推送<img src>中的非首屏图
配合 Link 响应头强化语义与优先级
单靠 http2_push 无法告诉浏览器“这个 CSS 很重要”，需用 Link 头补充语义：
- 添加
add_header Link '; rel=preload; as=style, ; rel=preload; as=image'; -
as=style让浏览器将 CSS 加入高优先级 preload 队列，立即解析；as=image则归入图像队列，调度权重更低 - 该头对动态内容（如 PHP/Python 后端）同样有效，只要上游服务返回对应
Link头，再配合http2_push_preload on;可触发推送（注意：http2_push与http2_push_preload不能共存于同一 location）
验证推送是否真正生效
不能只看配置有没有报错，要从传输层确认：
- Chrome DevTools → Network → 刷新页面 → 查看 “Protocol” 列是否为
h2，“Initiator” 列是否标为Push（而非Other或Parser） - 启用 Waterfall 视图，观察 CSS 推送流的 Start Time 是否明显早于图片，确认顺序有效
- 命令行验证：
nghttp -v https://your-domain.com/demo.html，输出中出现PUSH_PROMISE行即表示推送已发出 - 注意：若推送资源返回 404/500，Nginx 仍会发帧，但浏览器丢弃——建议用
try_files预检资源是否存在
