Linux PHP-FPM错误排查有哪些方法

Linux PHP-FPM 错误排查方法

一 快速定位流程

• 查看服务状态与失败原因：执行systemctl status php-fpm，若看到Active: failed (Result: start-limit)，说明短时间内多次启动失败触发了 systemd 的保护。先执行systemctl reset-failed php-fpm重置失败计数，再继续排查。
• 校验配置语法：执行php-fpm -t或带配置路径的**/usr/local/php8/sbin/php-fpm --test --fpm-config /usr/local/php8/etc/php-fpm.conf**，确保输出“configuration file … is valid”。
• 前台运行获取实时报错：执行**/usr/local/php8/sbin/php-fpm --nodaemonize --fpm-config /usr/local/php8/etc/php-fpm.conf**，可直接看到缺失模块、权限、路径等致命错误。
• 定位监听冲突：检查listen配置（如127.0.0.1:9000或**/run/php-fpm.sock**），并用ss -tulnp | grep 9000或netstat -tulnp | grep 9000确认端口占用；若冲突，修改 listen 或释放占用进程。
• 查阅错误日志：打开php-fpm.conf中的error_log路径（常见如**/var/log/php-fpm/error.log**），执行tail -n 50 /var/log/php-fpm/error.log；若日志文件或目录不存在，先创建并赋权（如www-data:www-data）。
• 检查运行用户与目录权限：确认**/var/run/php-fpm/、/var/log/php-fpm/、/run/php-fpm.sock**等可被 PHP-FPM 运行用户读写。
• 放宽系统资源限制：在**/usr/lib/systemd/system/php-fpm.service的[Service]段添加LimitNOFILE=65535**，随后systemctl daemon-reload并重启服务。

二 常见错误与处理要点

• 状态码78：通常表示配置文件错误（语法、路径、权限等）。先执行php-fpm -t定位，再检查listen、用户权限与日志路径。
• 502 Bad Gateway：多由PHP-FPM 未启动或与 Nginx/Apache通信失败导致。执行systemctl status/restart php-fpm，核对listen地址与 Web 服务器配置一致。
• 504 Gateway Timeout：脚本执行超时或进程不足。调整request_terminate_timeout（或 request_timeout）、提升pm.max_children，并优化慢脚本。
• Primary script unknown：常见于 Nginx未正确传递脚本路径。确保包含fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;且root路径正确。
• Permission denied（13）访问 Unix 套接字：在pool.d/www.conf核对listen.owner / listen.group / listen.mode，必要时调整为www-data:www-data与合适权限（如0660/0666），并重启服务。
• 进程池耗尽（pm.max_children reached）：并发超过上限。依据内存与负载调优pm.max_children / pm.start_servers / pm.min_spare_servers / pm.max_spare_servers，或切换pm策略（如 ondemand → dynamic）。
• 扩展缺失导致启动失败：执行php -m核对扩展，安装缺失模块（如数据库、curl 等）后重启。

三 与 Web 服务器和权限的联动检查

• Nginx 典型 FastCGI 配置要点：
  • 确保root指向正确站点目录；
  • location ~ .php$中包含fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;；
  • fastcgi_pass与 FPM 的listen一致（如unix:/run/php/php8.0-fpm.sock或127.0.0.1:9000）。
• 套接字权限与属主：若使用 Unix 套接字，核对listen.owner / listen.group / listen.mode，与 Nginx worker用户匹配，避免因权限拒绝导致502。
• 防火墙与端口：若使用TCP 9000，确认防火墙放行（如ufw allow 9000）；若使用Unix 套接字，则无需开放端口。

四 日志与性能调优建议

• 启用与观察日志：
  • 在php-fpm.conf设置error_log与合适的log_level（如notice/debug用于排障）；
  • 开启slowlog与request_slowlog_timeout，定位耗时脚本与阻塞点；
  • 对php-fpm.log配置logrotate做日志切割，避免过大影响磁盘与排查效率。
• 进程与内存调优：结合pm（static/dynamic/ondemand）、pm.max_children、pm.start_servers、pm.min/max_spare_servers与request_terminate_timeout进行压测与容量规划，避免504/502与进程耗尽。
• 资源与稳定性：必要时提升LimitNOFILE等 systemd 限制，减少“Too many open files”等限制引发的异常。