本文系统复盘 Nginx
502 Bad Gateway问题,从日志排查、Upstream 配置、FastCGI 超时,到性能优化与容量规划,帮助开发和运维团队快速定位与解决问题。
1. 问题现象
- 用户访问网站时偶尔返回
502 Bad Gateway Nginx error log 提示:
[error] 1234#0: *5678 recv() failed (104: Connection reset by peer) while reading response header from upstream高峰期频发,低流量时很少出现
2. 错误分析思路
2.1 502 的基本定义
502 Bad Gateway 表示 Nginx 作为反向代理,与 upstream(后端服务器、FastCGI 或 PHP-FPM)通信失败。主要可能原因:
- 后端服务不可用或异常
- 后端处理超时
- Nginx 配置不合理(如
proxy_read_timeout、fastcgi_read_timeout) - 网络或连接异常
2.2 日志排查
recv() failed/upstream timed out→ 后端未及时响应connect() failed→ 后端无法建立连接