Nginx 报 502 先看哪:error.log 里三种常见的后端失败

6次阅读
没有评论

打开网站直接看到「502 Bad Gateway」——这个页面的意思是:nginx 还活着,但它身后的应用(PHP-FPM、Node、Docker 容器都算)没响应。所以修 502 的正确姿势不是盯着 nginx 配置反复看,而是去看 nginx 的错误日志里记的是哪种失败。502 在 error.log 里主要有三种形态,对应三种完全不同的修法。

第一步:打开 error.log,先分型再动手

nginx 的错误日志位置一般在 nginx.conf 的 error_log 指令里,常见路径:

tail -50 /usr/local/nginx/logs/error.log
tail -50 /var/log/nginx/error.log

复现一次 502(刷新报错页面),然后立刻回来看最新几行。关键词决定方向:Connection refused 是一种,upstream timed out 是一种,no live upstreams 是第三种。逐个说。

形态一:Connection refused——后端根本没起

connect() failed (111: Connection refused) while connecting to upstream

nginx 按配置去连后端端口,对方端口上没有进程在听。确认两件事:

ss -tlnp | grep 后端端口
ps aux | grep -E "php-fpm|node|gunicorn" | grep -v grep

如果进程没了,先看它为什么死:系统日志里找 OOM(dmesg | grep -i "killed process"),内存爆掉被内核杀是深夜挂掉、早上才发现的典型原因;磁盘写满导致应用自杀是另一种,见这篇:Docker 容器没几个,系统盘为什么满了?。把应用拉起来之后,502 应该立刻消失;如果反复挂,问题在应用本身,别再折腾 nginx。

形态二:upstream timed out——后端活着但太慢

upstream timed out (110: Connection timed out) while reading response header

后端在,但规定时间内没回话。三个常见根源:一是后端真的在干重活(导出报表、图片处理、慢 SQL),单次请求就超过默认 60 秒;二是 PHP-FPM 进程耗尽,请求在队列里排队排到超时,看 pm.max_children 是否打满,ps aux | grep php-fpm | wc -l 对着配置数一下;三是后端和 nginx 之间走了不该走的网络路径(比如容器网络绕了一圈)。

对应的修法:慢请求该异步化就异步化,别让 HTTP 请求扛长任务;进程数按「内存 ÷ 单进程占用」算够再上调;nginx 侧的 proxy_read_timeout / fastcgi_read_timeout 只能兜底,把超时调大只是让用户等得更久,不是解法。

形态三:no live upstreams——负载均衡池里全挂了

配置了 upstream 多后端时出现,意思是轮询了一圈没有一个可用的。逐个后端按形态一、二排查即可。顺带提醒:给 upstream 配 max_fails 和 fail_timeout 能避免一个刚重启的后端被疯狂重试打死。

修好之后的三项确认

502 消失不等于修复完成,建议按这个顺序收尾:一看业务页,重点看登录、上传这些走 POST 的路径(GET 好了 POST 还坏的情况不少见);二看日志尾巴,error.log 里不应再有新增的 upstream 报错;三看反代头,如果后端拿到的访客 IP 全变成了 127.0.0.1,会导致限流、日志全歪,要用 X-Forwarded-For 和 trust proxy 修正,具体见这篇:反代后应用把所有访客识别成同一个 IP:真实 IP 与信任代理怎么配。

nginx 本身的基础配置检查(头、超时、缓冲),可以用在线 Nginx 配置检查工具先过一遍再动手改;如果你正在调 HTTP/2、HTTP/3 这些协议层的东西,这篇源码编译实录里有不少踩坑记录:Nginx 要同时开 Brotli 和 HTTP/3,官方镜像为什么不够用?

什么情况建议直接找支持

凌晨反复挂、白天自愈的间歇性 502 最难排查,因为它需要人在崩溃现场拿到证据(OOM 快照、慢查询、连接数曲线)。如果你已经清过日志、重启过服务还是周期性复发,把 error.log 最近 200 行和应用类型发到运维服务页,或邮件 admin@ticifer.com,这种「现场证据式」排查正好是远程支持效率最高的场景。

正文完
 0
Ticifer
版权声明:本站原创文章,由 Ticifer 于2026-11-19发表,共计1789字。
转载说明:除特殊说明外本站文章皆由CC-4.0协议发布,转载请注明出处。
腾讯轻量一键开服,热卖套餐配置低至32元/月起
推广 · 腾讯云轻量服务器,一键开服,热卖套餐低至 32 元/月起
评论(没有评论)