使用Nginx HTTP/2反向代理部署Polymer PWA时出现502错误求助

看起来你遇到的问题是Nginx反向代理prpl-server时，唯独应用壳文件ma-app.html返回502错误，其他资源都正常加载。这种情况通常和后端路由匹配、Nginx代理配置或者请求头传递有关，下面我会一步步帮你排查和解决：

第一步：先确认后端prpl-server本身是否能正确返回ma-app.html #

首先跳过Nginx，直接访问http://127.0.0.1:38765/ma-app.html，看看是否能得到200状态码和正确的文件内容：

• 如果直接访问也失败，那问题出在prpl-server的配置上：

  • prpl-server默认会寻找index.html作为入口文件，如果你用ma-app.html作为应用壳，需要在启动命令中指定--entry ma-app.html，或者在prpl-server的配置文件里明确设置入口点。
  • 可以启动prpl-server时加上--verbose参数，查看详细日志，确认它是否收到了ma-app.html的请求，以及有没有报错信息。

• 如果直接访问正常，那问题就出在Nginx的代理配置上，继续往下看。

第二步：检查Nginx的反向代理配置 #

打开你的/etc/nginx/sites-available/default配置文件，重点检查以下几点：

1. 确保代理使用HTTP/1.1（后端prpl-server通常不支持HTTP/2） #

即使Nginx启用了HTTP/2对外服务，反向代理到后端prpl-server时必须使用HTTP/1.1，否则会出现连接异常。添加以下配置到对应的location块中：

location / {
    proxy_pass http://127.0.0.1:38765;
    # 关键配置：强制使用HTTP/1.1
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    
    # 传递必要的请求头，确保后端能正确识别请求
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

2. 调整代理Buffer大小，避免因响应过大导致502 #

有时候ma-app.html可能包含较多的内联资源或者响应头，超过Nginx默认的代理缓冲区大小，会触发502错误。可以尝试增大缓冲区配置：

location / {
    # 其他代理配置...
    proxy_buffer_size 128k;
    proxy_buffers 4 256k;
    proxy_busy_buffers_size 256k;
}

3. 确保请求头完整传递 #

prpl-server可能依赖Accept等请求头来正确返回资源，检查Nginx是否没有修改或丢弃这些头。可以显式添加：

proxy_set_header Accept $http_accept;

第三步：查看Nginx错误日志，定位具体原因 #

Nginx的错误日志通常在/var/log/nginx/error.log，搜索ma-app.html相关的日志条目，看看502对应的具体错误信息：

• 如果日志显示upstream prematurely closed connection，说明后端prpl-server在返回响应前断开了连接，可能是路由不匹配或者prpl-server处理请求出错。
• 如果显示no live upstreams while connecting to upstream，说明Nginx无法连接到prpl-server，检查端口是否正确，prpl-server是否正常运行。

第四步：模拟Nginx的请求，验证转发是否正确 #

用curl模拟Nginx发送给prpl-server的请求，带上相同的Host头：

curl -H "Host: your-domain.com" http://127.0.0.1:38765/ma-app.html -v

对比直接访问和模拟请求的返回结果，如果模拟请求返回502，说明prpl-server对带特定Host头的请求处理有问题，需要调整prpl-server的配置允许该Host访问。

最后：重启Nginx并验证 #

修改配置后，重启Nginx生效：

sudo systemctl restart nginx

然后再次访问页面，检查ma-app.html是否返回200状态码。

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