Nginx服务器出现502 Bad Gateway的排查与解决方法

服务器出现 502 bad gateway，通常不是 nginx 自己“坏了”，而是 nginx 无法正常连接后端服务。

最常见的情况包括：后端程序没启动、端口写错、进程崩溃、代理地址配置错误，或者 unix socket 权限有问题。

下面按实际排查顺序来处理。

1. 先看后端服务是否还活着

假设 nginx 配置里写的是：

proxy_pass http://127.0.0.1:3000;

先检查 3000 端口：

ss -lntp | grep 3000

如果没有任何输出，说明后端程序大概率没有启动。

如果是 systemd 管理的服务，可以查看：

systemctl status myapp

如果看到：

inactive
failed

就先处理后端程序本身。

2. 直接绕过 nginx 测试后端

在服务器本机执行：

curl http://127.0.0.1:3000

如果这里能正常返回内容，说明后端基本没问题，可以继续检查 nginx。

如果出现：

connection refused

通常说明端口没有监听。

如果一直卡住，则可能是程序本身阻塞或者响应异常。

这个测试很重要，因为它能快速判断问题到底在 nginx，还是在后端应用。

3. 检查 proxy_pass 地址

例如：

location /api/ {
    proxy_pass http://127.0.0.1:3000;
}

重点检查几个地方：

ip 是否正确
端口是否正确
http / https 是否写对
后端是否真的监听这个地址

例如后端实际运行在：

127.0.0.1:8080

但 nginx 配成：

proxy_pass http://127.0.0.1:3000;

访问时自然会出现 502。

4. 查看 nginx 错误日志

如果还没找到原因，直接看日志。

常见路径：

tail -f /var/log/nginx/error.log

或者：

tail -n 100 /var/log/nginx/error.log

比较常见的错误是：

connect() failed (111: connection refused)

通常说明后端没有监听。

如果看到：

upstream timed out

说明后端响应太慢或者卡住了。

如果看到：

permission denied

则要检查文件、socket 或 selinux 等权限问题。

5. 检查后端是不是刚启动就崩了

有时候执行：

systemctl restart myapp

状态短暂显示正常，但几秒之后又退出。

可以查看：

journalctl -u myapp -n 100

常见原因包括：

环境变量缺失
数据库连接失败
端口冲突
依赖缺失
配置文件错误
程序异常退出

这种情况下，502 只是表面现象，真正的问题还是应用启动失败。

6. 检查 nginx 配置有没有写错

修改配置后先执行：

nginx -t

正常会看到：

syntax is ok
test is successful

然后再重新加载：

systemctl reload nginx

如果语法有问题，不要直接重启 nginx。

7. 后端使用 docker 时要额外注意

如果应用运行在 docker 中，先检查容器：

docker ps

如果容器已经退出：

docker ps -a

然后查看日志：

docker logs 容器id

还要确认端口映射。

例如：

0.0.0.0:3000->3000/tcp

如果容器内部监听 3000，但宿主机没有正确映射，nginx 同样访问不到。

8. 还有一种常见情况：后端压力过大

如果 502 不是一直出现，而是偶尔出现，可以检查服务器资源：

top

查看内存：

free -h

查看磁盘：

df -h

如果 cpu 长期跑满、内存耗尽，或者后端处理请求过慢，也可能导致 nginx 连接 upstream 失败。

一套比较实用的排查顺序

遇到 502 时，我一般按下面几步检查：

nginx -t

然后：

ss -lntp | grep 后端端口

接着：

curl http://127.0.0.1:后端端口

再看：

tail -n 100 /var/log/nginx/error.log

如果后端由 systemd 管理：

journalctl -u 服务名 -n 100

绝大多数 502 问题，到这里基本都能定位。

简单来说，502 的核心就是 nginx 找不到或者无法正常访问 upstream。先确认后端活着，再检查端口和 proxy_pass，最后结合 nginx 与应用日志排查，比反复重启服务有效得多。

以上就是nginx服务器出现502 bad gateway的排查与解决方法的详细内容，更多关于nginx 502 bad gateway排查与解决的资料请关注代码网其它相关文章！