2025年Http状态码502常见原因及排错思路（实战）

大家好，我是讯享网，很高兴认识大家。

Http状态码502常见原因及排错思路

502表示Bad Gateway。当Nginx返回502错误时，通常表示Nginx作为代理服务器无法从上游服务器（如：我们的后端服务器地址）获取有效的响应。导致这种情况的原因有很多：

后端服务器故障

nginx配置问题

高负载或者资源耗尽

nginx与后端服务器通信问题

必出现502：应用挂了（服务端返回RST，nginx或者其他发出502报错）
偶尔出现502：CPU使用率高 / QPS增加 / nginx read超时时间设置问题

504 Gateway timeout 网关超时

一般指nginx做反向代理服务器时，所连接的服务器tomcat无响应导致的。

为了完成您的 HTTP 请求，该服务器访问一个上游服务器，但没得到及时的响应

nginx超过了自己设置的超时时间

502常见原因及排错思路

1. 后端服务器故障

检查后端服务器是否正常运行，网络连接是否正常。 可以通过 ping 命令检查网络连接：ping your_backend_server_ip 通过 telnet 命令检查后端服务器的端口是否开启：telnet your_backend_server_ip your_backend_server_port 通过 curl 命令测试后端服务器的响应：curl -I http://your_backend_server_url

讯享网

2. 网关配置问题：代理地址、请求超时时间

以Nginx作为网关为例：

讯享网检查 Nginx 配置文件中的代理设置，确保代理到后端服务器的配置正确。 检查超时时间配置：proxy_read_timeout 2s; #vim /opt/nginx/nginx.conf 检查 Nginx 错误日志，查看是否有相关的错误信息：tail -f /var/log/nginx/error.log

3. 后端服务器高负载或者资源耗尽：某一时刻qps过高

# 可能是某一瞬间，服务器的qps过高导致502 可以使用 top 命令查看系统资源（CPU、MEM）使用情况

4. 网关与服务器通信问题（网络连接、端口开放等）

讯享网检查 Nginx 与后端服务器之间的防火墙设置，确保端口开放。 检查 Nginx 与后端服务器之间的网络连接是否正常，可以通过抓包工具（如 tcpdump）检查网络通信情况。

实战

1. 查看nginx.conf：观察是否是代理配置错误

首先想到是不是nginx的代理配置出了问题，结果发现nginx.conf配置文件是没有问题的，配置的代理也是正确指向我们后端服务的地址。

 server { 
    listen 80; location / { 
    proxy_pass http://localhost:6020; } location /backend-api { 
    rewrite ^/backend-api(.*)$ $1 break; proxy_pass http://192.168.64.145; } }

查看能否ping通后端服务器，发现也是通的

讯享网ping 192.168.64.145

2. 查看/var/log/nginx/error.log：查看nginx报错信息

然后准备查看nginx的报错日志信息

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

发现错误信息如下：

讯享网2023/11/12 11:07:26 [error] 49448#49448: *1998 connect() failed (111: Connection refused) while connecting to upstream, client: 10.3.0.52, server: , request: "GET /backend-api/list HTTP/1.1", upstream: "http://192.168.64.145:80/list", host: "10.16.13.137", referrer: "http://192.168.64.120/page/xx"

可以看出是nginx请求我们后端的服务器没有请求成功。

讯享网

3. 检查后端服务是否正常运行

# 查看服务pod是否是running状态 kubectl get pods -n xxx

运行命令后，发现处理服务的pod状态都是正常的。

然后想到nginx请求我们的是80端口，于是通过检查端口是否处于Listen状态即可

讯享网netstat -ano | grep 80

结果发现服务器上的80端口没有被过滤出来，马上联想到是不是80端口没有开放出来

firewall-cmd --zone=public --list-ports | grep 80 # 执行命令后发现FirewallD is not running # 查看防火墙状态 systemctl status firewalld # 发现防火墙已经是关闭状态（为了方便测试，暂时关闭），因此防火墙不会阻拦80端口的请求

这个时候突然想到是不是ingress问题，执行命令查看k8s event信息

讯享网# 发现是有报磁盘资源不足 kubectl get event # 查看pod详细信息，包括event # kubectl describe pod podName

在这里插入图片描述

# 查看所有节点状态 kubectl get pod -n kube-system -o wide # kubectl get pods -A -o wide

在这里插入图片描述
发现配置的ingress pod被驱逐。

讯享网# 查看磁盘使用情况，清理对应磁盘之后发现ingress正常工作 df -h

拓展：HTTP状态码合集

HTTP状态码合集