Nginx 502 Bad Gateway 排查手册:从网关报错到后端恢复的完整路径

举报
yd_282937315 发表于 2026/11/04 08:45:43 2026/11/04
【摘要】 线上访问突然返回 502 Bad Gateway,意思是 Nginx 作为反向代理收到了后端无效或无响应。不要一上来就重启,先分层定位:是 Nginx 本身问题、后端挂了,还是两者之间的连接断了。一、先看 Nginx 错误日志:tail /var/log/nginx/error.log,重点看 upstream timed out、connect() failed、upstream prem...

线上访问突然返回 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 本质是代理与后端之间的握手失败,按日志、后端存活、配置、资源四层逐级对照,大多数故障半小时内可以定位。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。