服务器重启或应用重部署后，Nginx反向代理的Node.js生产环境出现502 Bad Gateway问题求助

阿华AIGC实验室

2026-3-26

大家好，我现在在Ubuntu服务器上部署Node.js Web应用，用Nginx做反向代理，还搭配了PM2做进程管理。手动启动应用的时候一切正常，但每次服务器重启或者重新部署应用后，偶尔会遇到Nginx返回502 Bad Gateway的错误，折腾好几次了有点头疼，想请教下社区的大佬们可能的原因和解决办法。

我的环境配置

Ubuntu 服务器
Node.js 后端服务运行在端口3000
Nginx 作为反向代理
PM2 负责进程管理

我的Nginx配置片段

server {
    listen 80;
    server_name my-app-domain.com;

    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

目前我试过手动重启Nginx和PM2服务，有时候能恢复，但不是每次都管用，而且没法从根源解决问题。

社区经验分享（我之前踩过同款坑）

兄弟，我维护Node.js生产环境的时候也碰过这个糟心的502问题，给你梳理几个大概率的原因和对应的解决办法，你可以挨个排查：

1. PM2没设开机自启，服务器重启后Node服务根本没起来

这是最常见的坑！你手动启动PM2后服务正常，但服务器重启后PM2自己没启动，Node服务自然也没起来，Nginx连3000端口当然返回502。

解决步骤：
1. 运行pm2 startup ubuntu -u 你的服务器用户名，生成PM2的开机自启脚本
2. 再运行pm2 save，把当前正在运行的Node进程列表保存下来
3. 重启服务器后，用pm2 list检查你的应用是不是处于online状态

2. Nginx比Node服务先启动，启动时端口还没被监听

服务器重启时，systemd的启动顺序可能让Nginx先起来了，这时候Node服务还在启动过程中，3000端口没被监听，Nginx就会缓存这个错误状态，即使后来Node服务起来了也可能不自动重试。

解决办法：
- 方法一：调整Nginx的启动顺序，让它等PM2的服务起来后再启动。先通过systemctl list-units | grep pm2找到PM2的系统服务名（一般是pm2-你的用户名.service），然后编辑Nginx的systemd配置文件/lib/systemd/system/nginx.service，在[Unit]块里加一行：
```
After=network.target pm2-你的用户名.service
```
  然后运行systemctl daemon-reload生效
- 方法二：在Nginx的location块里加代理超时和重试配置，即使一开始连不上，后面也会重试：
```
proxy_connect_timeout 30s;
proxy_send_timeout 30s;
proxy_read_timeout 30s;
proxy_next_upstream error timeout invalid_header http_502;
```
- 方法三：在你的部署脚本里加个等待逻辑，等Node服务完全启动后再重载Nginx：
```
# 循环检查3000端口是否被监听，每1秒查一次
while ! nc -z localhost 3000; do
  sleep 1
done
# 端口正常后重载Nginx
systemctl reload nginx
```

3. Node服务启动失败（比如依赖缺失、环境变量没加载、数据库连不上）

有时候PM2起来了，但你的Node服务因为各种原因启动失败，这时候3000端口还是没被监听。

排查方法：
1. 用pm2 logs 你的应用名查看Node服务的启动日志，有没有报错信息
2. 用netstat -tulpn | grep 3000检查3000端口有没有被进程占用
解决：根据日志里的错误修复，比如补全缺失的依赖（重新运行npm install --production）、检查环境变量配置、修复数据库连接问题