网站Docker环境502 Bad Gateway_性能优化与预防_MySQL连接优化_运维经验
502 Bad Gateway和504 Gateway Timeout是两种常见的网关错误，容易混淆。502是上游服务器返回了无效响应（如连接被拒绝、连接重置、返回格式错误），504是上游服务器超时未响应。两者的原因和处理方法不同，需要准确区分。本文重点讲解502 Bad Gateway，同时对比504的区别，帮助站长准确判断和处理。
第三步是检查Nginx配置。Nginx的fastcgi_pass配置错误会导致502，如PHP-FPM的监听地址或端口不正确。PHP-FPM默认监听127.0.0.1:9000或unix socket（如/run/php/phpX.X-fpm.sock），Nginx的fastcgi_pass必须与PHP-FPM的listen配置一致。检查Nginx错误日志：/var/log/nginx/error.log，502错误会记录具体原因，如"connect() failed (111: Connection refused) while connecting to upstream"表示PHP-FPM未启动或端口不对，"upstream sent invalid header"表示PHP返回了无效响应。根据日志中的错误信息针对性处理。
第二步是检查服务器资源。CPU、内存、磁盘空间不足都会导致后端服务无法正常响应，出现502。使用top或htop查看CPU使用率，如果CPU持续100%，可能是程序死循环或被攻击。使用free -m查看内存使用，如果内存不足（available接近0），系统可能OOM杀掉PHP-FPM进程，查看dmesg或/var/log/messages中的OOM记录。使用df -h查看磁盘空间，如果磁盘满了，MySQL和PHP-FPM可能无法写入临时文件导致异常。资源不足是502错误的常见原因，尤其是高峰期。
第六步是检查MySQL和后端服务。PHP程序连接MySQL超时或失败，可能导致PHP-FPM进程挂起，最终502。检查MySQL服务状态，查看慢查询日志，优化慢SQL。MySQL连接数满了（max_connections），新连接被拒绝，PHP等待超时。检查MySQL的连接数：SHOW STATUS LIKE 'Threads_connected';，如果接近max_connections，增加连接数或优化程序释放连接。其他后端服务（如Redis、Memcached、API接口）不可用也可能导致PHP超时502，检查所有依赖服务的状态。
第五步是检查PHP程序和扩展。PHP代码中的致命错误（如调用不存在的函数、内存溢出、死循环）可能导致PHP-FPM进程崩溃，返回502。查看PHP错误日志：/var/log/php/error.log或PHP-FPM错误日志，找到致命错误的文件和行号，修复代码。PHP扩展冲突或版本不兼容也可能导致PHP-FPM崩溃，禁用最近安装的扩展测试。PHP的memory_limit设置过小，大内存操作导致进程被杀，根据需要调整。上传大文件时，post_max_size和upload_max_filesize设置过小也可能导致异常。
预防502错误的最佳实践：监控服务器资源（CPU、内存、磁盘、连接数），设置告警阈值，资源异常时及时处理；监控PHP-FPM和Nginx的错误日志，502错误增加时告警；合理配置PHP-FPM进程数，根据服务器内存调整；设置request_terminate_timeout防止死循环；使用OPcache提升PHP性能，减少响应时间；使用缓存（Redis、Memcached）减少数据库查询；优化SQL查询，避免慢查询；使用CDN缓存静态资源，减轻源站压力；定期更新PHP和Nginx版本，修复已知bug；进行压力测试，了解服务器承载能力，提前扩容。
真实经历：网站迁移后502，Nginx日志显示connect() failed (111: Connection refused)，检查PHP-FPM配置发现listen是unix socket，但Nginx的fastcgi_pass配置的是127.0.0.1:9000，两者不匹配。统一为socket方式后问题解决。Nginx和PHP-FPM的监听方式必须一致，这是迁移后常见的配置问题。
排查提醒：遇到502错误先看Nginx错误日志，日志中会记录具体原因（连接拒绝、无效响应、超时等），根据日志针对性排查，不要盲目重启。检查PHP-FPM状态和服务器资源，这是502最常见的两个原因。修改配置后重启对应服务并测试。
更新时间：2026-08-26 23:35:53
上一篇：35互联虚拟主机后台目录限制 IP配置教程_Nginx 虚拟主机IP黑名单写法