网站持续502 Bad Gateway应急处理_常见错误配置纠正_PHP配置优化
网站出现502 Bad Gateway时，用户看到错误页面无法访问，站长需要快速定位和解决。502错误的特点是间歇性，有时候正常有时候报错，排查起来比较困难。常见于Nginx+PHP-FPM架构，PHP-FPM进程挂掉或资源不足时Nginx返回502。也可能是后端服务超时、网络问题、配置错误等原因。系统的排查方法是从前端到后端逐层检查，定位问题所在。本文提供完整的排查流程和解决方案。
第三步是检查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返回了无效响应。根据日志中的错误信息针对性处理。
排查502错误的第一步是确认后端服务状态。Nginx+PHP-FPM架构下，最常见的原因是PHP-FPM服务停止或崩溃。检查PHP-FPM状态：systemctl status php-fpm（Linux），查看服务是否运行。如果服务停止，启动PHP-FPM：systemctl start php-fpm。查看PHP-FPM的错误日志，通常在/var/log/php-fpm/或/var/log/phpX.X-fpm.log，日志中会记录崩溃原因。如果PHP-FPM频繁崩溃，可能是内存不足、PHP扩展冲突、程序死循环等原因，需要进一步排查。
第五步是检查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设置过小也可能导致异常。
第六步是检查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，检查所有依赖服务的状态。
预防502错误的最佳实践：监控服务器资源（CPU、内存、磁盘、连接数），设置告警阈值，资源异常时及时处理；监控PHP-FPM和Nginx的错误日志，502错误增加时告警；合理配置PHP-FPM进程数，根据服务器内存调整；设置request_terminate_timeout防止死循环；使用OPcache提升PHP性能，减少响应时间；使用缓存（Redis、Memcached）减少数据库查询；优化SQL查询，避免慢查询；使用CDN缓存静态资源，减轻源站压力；定期更新PHP和Nginx版本，修复已知bug；进行压力测试，了解服务器承载能力，提前扩容。
站长反馈：网站高峰期频繁502，排查后发现是PHP-FPM的max_children设置过小（默认5），高峰期请求排队超时。根据服务器内存调整到30，同时优化了SQL查询，502问题基本解决。PHP-FPM的默认配置不适合生产环境，需要根据服务器配置调整。
排查提醒：遇到502错误先看Nginx错误日志，日志中会记录具体原因（连接拒绝、无效响应、超时等），根据日志针对性排查，不要盲目重启。检查PHP-FPM状态和服务器资源，这是502最常见的两个原因。修改配置后重启对应服务并测试。
更新时间：2026-08-26 21:36:35
上一篇：域名A记录被篡改到0.0.0.0_常见问题解答_DNS安全防护