如何调试Linux PHP-FPM问题

Linux PHP-FPM 问题排查与调试指南

一 快速定位故障

• 确认服务状态与进程：使用 systemctl status php{version}-fpm 查看是否运行；用 pgrep php-fpm 检查进程是否存在。若未运行，优先查看服务启动失败原因。
• 核对监听地址与端口/套接字：用 ss -lntp | grep php 或 netstat -plnt | grep php 确认监听；若为 Unix 套接字，检查文件是否存在与权限：ls -l /var/run/php/php{version}-fpm.sock。
• 查看系统日志：使用 journalctl -u php{version}-fpm -xe 获取服务启动、崩溃、重启等详细线索。
• 访问状态页（如已启用）：在浏览器访问 http://localhost/status_page（对应 pm.status_path），可快速查看进程池与排队情况。
• 重启生效：修改配置后执行 systemctl restart php{version}-fpm；必要时设置开机自启 systemctl enable php{version}-fpm。

二 日志与配置核对

• 定位日志文件：PHP-FPM 错误日志常见路径为 /var/log/php{version}-fpm.log 或 /var/log/php-fpm/error.log；实时查看可用 tail -f。
• 配置关键项：主配置 /etc/php/{version}/fpm/php-fpm.conf，进程池 /etc/php/{version}/fpm/pool.d/www.conf。重点核对 listen（套接字或端口）、user/group、日志路径与级别。
• 开启慢日志定位性能瓶颈：在 www.conf 中启用
  • slowlog = /var/log/php-fpm/www-slow.log
  • request_slowlog_timeout = 3（单位秒）
    重启后在慢日志中可直接看到具体脚本与行号。
• 捕获脚本输出与错误：在 www.conf 中设置
  • catch_workers_output = yes
  • php_admin_flag[log_errors] = on
  • 必要时使用 php_admin_value[error_log] 指定日志文件
• 权限与属主：确保 /var/log/php-fpm/ 及网站根目录对 www-data（或相应运行用户）可读写；套接字文件权限常见为 0660，属主 www-data:www-data。

三 常见故障场景与修复

• 启动失败：优先查看 journalctl 与 php-fpm.log；常见原因为 listen 地址冲突、配置语法错误、日志目录不可写。若监听端口被占用，改用其他端口或停止占用者；若套接字路径不存在或权限错误，修正路径与权限后重启。
• 502/504 网关错误：多为 PHP-FPM 未运行、监听地址与 Nginx/Apache 不一致、或 权限/SELinux/AppArmor 拦截。核对 fastcgi_pass（如 unix:/run/php/php{version}-fpm.sock 或 127.0.0.1:9000）与 FPM 的 listen 完全一致；检查 /var/run/php/ 目录权限；临时禁用 SELinux/AppArmor 验证是否策略导致。
• 权限与属主问题：网站目录与日志目录应归属 www-data:www-data，常用权限 755/644；套接字需 0660 并属 www-data。
• 资源不足与不稳定：进程数不足或内存超限会导致 502/504 或响应抖动。结合负载与内存，调整 pm.max_children、pm.start_servers、pm.min_spare_servers、pm.max_spare_servers；必要时启用 OPcache 降低解析开销。

四 性能与高占用排查

• 快速识别异常进程：用 top/htop 按 CPU 或 MEM 排序；或用
  • ps aux --sort=-%cpu | head
  • ps aux --sort=-%mem | head
• 深入系统调用与资源：对可疑 PID 执行
  • strace -p -T -tt -e trace=all -o fpm-strace.log（跟踪系统调用）
  • lsof -p （打开文件）
  • pmap -x （内存映射）
• 慢请求定位：依赖前述 慢日志 找出耗时脚本与行号，优先优化 SQL、外部 API、循环与缓存命中。
• 连接与超时：结合 request_terminate_timeout、max_execution_time、pm.max_children 与 数据库/缓存连接池 设置，避免雪崩与级联超时。

五 配置与运维建议

• 进程管理策略：按负载选择 pm = dynamic/ondemand/static；动态模式常用参数为 pm.max_children、pm.start_servers、pm.min_spare_servers、pm.max_spare_servers，必要时设置 pm.max_requests 定期回收进程，缓解内存碎片与泄漏。
• 资源与连接：提升 ulimit -n（文件描述符）；合理设置 request_terminate_timeout 与 max_execution_time；数据库与缓存使用连接池并设定合理超时。
• 缓存与加速：启用 OPcache（如 memory_consumption、max_accelerated_files、revalidate_freq），显著提升响应速度并降低 FPM 压力。
• 日志治理：为 error.log/access.log 配置 logrotate 做按日轮转与压缩，避免磁盘被占满；仅在排障时临时提高日志级别。
• 监控与告警：结合 Prometheus + Grafana 或系统监控，持续观察 进程数、排队、响应时延、慢请求 等指标，配合阈值告警。