Nginx 502 Bad Gateway 排查手册:从网关报错到后端恢复的完整路径
线上访问突然返回 502 Bad Gateway,意思是 Nginx 作为反向代理收到了后端无效或无响应。不要一上来就重启,先分层定位:是 Nginx 本身问题、后端挂了,还是两者之间的连接断了。
一、先看 Nginx 错误日志:tail /var/log/nginx/error.log,重点看 upstream timed out、connect() failed、upstream prematurely closed connection 这三类。timed out 多是后端处理太慢或连接池耗尽;connect failed 多是后端没启动、端口不对或防火墙拦截;prematurely closed 多是后端崩溃或在响应中途断开。
二、查后端是否活着:curl 本机后端地址直接访问,绕过 Nginx 对照;用 ss -tlnp 确认监听端口与进程;检查后端进程是否 OOM 被杀(dmesg / 系统日志),以及磁盘满、连接数打满等连带问题。
三、查 Nginx 与后端之间的配置:proxy_pass 地址与端口是否与后端实际监听一致;upstream 里写错端口、后端扩容后漏加节点都很常见;检查 proxy_connect_timeout、proxy_read_timeout 是否过短,大接口、慢查询场景下超时要按业务合理放宽,而不是一味调大掩盖慢后端。
四、查资源与限流:后端线程池/连接池满、数据库连接打满、文件描述符耗尽都会表现为间歇性 502;用 top、free、后端连接数指标对照高峰时段,确认是容量问题还是偶发抖动。
五、恢复与预防:应急先确认能否切备用后端或降级止血,再修根因;修复后用 curl 多次复测并观察错误日志是否停止增长;预防包括后端健康检查、upstream 备用节点、超时与重试策略合理配置、错误日志与 502 率告警,出现突增立即定位,不要等用户反馈才发现。
结论:502 本质是代理与后端之间的握手失败,按日志、后端存活、配置、资源四层逐级对照,大多数故障半小时内可以定位。
- 点赞
- 收藏
- 关注作者
评论(0)