Nginx部署Blazor Server遇upstream连接提前关闭及502 Bad Gateway问题

针对你遇到的Nginx日志提示upstream prematurely closed connection while reading response header from upstream、客户端显示502的问题，按以下步骤逐一排查：

1. 确认Blazor Server应用自身状态 #

• 直接在服务器上访问http://127.0.0.1:7155，验证应用是否能正常响应：
  • 如果无法访问，检查应用是否已启动，端口7155是否被其他进程占用（执行netstat -tulpn | grep 7155或ss -tulpn | grep 7155查看）
  • 查看.NET应用的启动日志（控制台输出或应用目录下的日志文件），确认是否有启动失败、依赖缺失、绑定IP错误等异常
  • 确保应用绑定的是127.0.0.1:7155，而非仅localhost（部分环境下localhost解析可能存在异常）

2. 验证Nginx与应用的网络连通性 #

• 在服务器上执行curl -v http://127.0.0.1:7155，观察输出：
  • 如果返回连接超时/拒绝，说明Nginx无法连接到应用进程，重点排查应用状态、端口占用情况
  • 检查防火墙/SELinux是否拦截本地端口访问：临时关闭SELinux（执行setenforce 0）测试，或添加规则允许127.0.0.1:7155的TCP连接

3. 补充Blazor Server必需的Nginx配置项 #

Blazor Server依赖WebSocket维持长连接，你的当前配置缺少WebSocket代理相关的头信息，这是核心问题之一。修改/sites-enabled/下的server配置块，在location /中添加：

proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";

同时修正proxy_send_timeout的格式（补全s单位）：

proxy_send_timeout 10080s;

修改后的完整location块示例：

location / {
    proxy_pass http://dotnet;
    proxy_set_header Host $host;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_http_version 1.1;
    proxy_temp_file_write_size 64k;
    proxy_connect_timeout 10080s;
    proxy_send_timeout 10080s;
    proxy_read_timeout 10080s;
    proxy_buffer_size 64k;
    proxy_buffers 16 32k;
    proxy_busy_buffers_size 64k;
    proxy_redirect off;
    proxy_request_buffering off;
    proxy_buffering off;
}

4. 启用详细日志定位问题 #

• 调整Nginx日志级别为debug，修改nginx.conf中的日志配置：

  error_log /var/log/nginx/error.log debug;
  

  重启Nginx后，再次访问应用，查看debug日志中的具体错误细节，比如连接时的握手失败信息
• 开启Blazor Server的详细日志：在appsettings.json中设置Logging级别为Debug，查看应用端是否有连接中断的日志

5. 检查权限相关问题 #

• 确认Nginx运行用户www-data是否有足够权限访问应用相关资源（虽然本地端口访问一般不受文件权限影响，但如果应用有特殊文件读取需求，需验证）

完成上述步骤后，重启Nginx和Blazor Server应用，再测试访问。

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