Magento 2：Nginx+Varnish环境下http2_push配置无效问题排查

核心问题分析 #

你当前配置的http2_push未生效，大概率是以下几个原因导致：

1. Nginx基础配置不达标 #

• HTTP2未真正启用：HTTP2几乎只支持HTTPS场景，且需要在listen指令中显式声明http2参数。如果你的server块监听配置是listen 443 ssl;而不是listen 443 ssl http2;，那HTTP2根本没开启，自然无法推送。
• Nginx版本过低：http2_push是Nginx 1.13.9及以后才正式支持的指令，老版本会直接忽略该配置。执行nginx -v确认版本。

2. 静态资源路径不匹配（最常见） #

Magento的静态资源会自动添加版本号参数（比如styles-l.css?abc123），但你配置的http2_push路径是不带版本号的纯路径。浏览器会认为推送的资源和实际请求的资源是两个不同URL，直接忽略推送内容。

3. 浏览器缓存干扰 #

如果浏览器已经缓存了这些CSS文件，就不会触发推送逻辑。测试时必须开启浏览器的「禁用缓存」选项。

4. 代理场景下的配置遗漏 #

使用proxy_pass时，若未正确传递或配置推送相关的响应头，也会导致推送失效。

修复步骤 #

步骤1：修正Nginx基础配置 #

确保server块的监听配置正确启用HTTP2：

server {
    listen 443 ssl http2;
    ssl_certificate /path/to/your/ssl/cert.pem;
    ssl_certificate_key /path/to/your/ssl/key.pem;
    # 其他SSL配置...
}

执行nginx -s reload生效配置。

步骤2：改用Link头推送（适配Magento版本号） #

放弃直接写死http2_push路径，改用基于Link响应头的自动推送，适配Magento的静态资源版本号：

location / {
    proxy_pass         http://xx.xxx.xxx.xx:6081;
    proxy_redirect      off;
    proxy_set_header    X-Real-IP $remote_addr;
    proxy_set_header    X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header    X-Forwarded-Host $server_name;
    proxy_set_header    X-Forwarded-Port 443; # 改为实际HTTPS端口，之前的8080错误
    proxy_set_header    Host $host;
    proxy_set_header    X-Forwarded-Country $geoip_country_code;
    
    # 开启基于Link头的自动HTTP2推送
    http2_push_preload on;
    # 传递Magento后端生成的Link预加载头
    proxy_pass_header Link;
}

步骤3：配置Magento输出Link头 #

登录Magento后台，进入Stores > Configuration > Advanced > Developer > Static Files Settings，设置：

• Sign Static Files为Yes

这样Magento会自动为静态资源添加版本号，并在响应头中输出对应的Link预加载指令，Nginx会基于这些指令自动推送资源。

验证推送效果 #

1. 打开Chrome开发者工具（F12），切换到Network面板，勾选Disable cache
2. 刷新页面，查看CSS资源的Initiator列，若显示Push则说明推送成功
3. 也可在Headers面板查看响应头是否包含Link字段，里面会列出预加载的资源路径

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