Linux PHP-FPM错误日志怎么分析

Linux PHP-FPM 错误日志分析实操指南

一 定位日志与快速查看

• 常见日志路径与定位方式
  • PHP-FPM 错误日志：常见为 /var/log/php-fpm/error.log；也可能由 php.ini 的 error_log 指定，或定义在 /etc/php/{version}/fpm/pool.d/www.conf 的 php_admin_value[error_log]。
  • Web 服务器错误日志：Nginx /var/log/nginx/error.log，Apache /var/log/httpd/error_log。
  • 不确定位置时，可用 php --ini 查看加载的 php.ini，或在 www.conf 中查 error_log 指令。
• 快速查看与过滤
  • 实时查看：tail -f /var/log/php-fpm/error.log
  • 关键字检索：grep -i “error|fatal|warning” /var/log/php-fpm/error.log
  • systemd 日志：journalctl -u php{version}-fpm -f（按实际版本替换）
• 建议同时打开 Web 服务器错误日志，便于交叉定位（如 502/504 等网关错误）。

二 关键配置与日志级别

• 在 /etc/php/{version}/fpm/pool.d/www.conf 中调整日志相关指令（示例）：
  • 指定日志文件与级别：
    • php_admin_value[error_log] /var/log/php-fpm/custom_error.log
    • php_admin_flag[log_errors] on
    • php_admin_value[error_reporting] E_ALL & E_DEPRECATED & E_STRICT
    • catch_workers_output yes（便于捕获子进程输出）
  • 慢日志定位性能瓶颈：
    • slowlog = /var/log/php-fpm/www-slow.log
    • request_slowlog_timeout = 5s（示例阈值）
• 在 php.ini 中建议：
  • error_reporting = E_ALL，log_errors = On，display_errors = Off（生产环境不在浏览器显示错误）
• 修改后重启生效：systemctl restart php{version}-fpm。

三 常见错误模式与排查路径

• 502 Bad Gateway：PHP-FPM 未启动/崩溃，或 Nginx/Apache 与 FPM 通信失败（监听地址/套接字不一致、端口冲突）。

  • 处置：检查状态与重启 systemctl status/restart php-fpm；核对 listen 与 Web 配置一致；端口占用用 netstat -tulnp | grep 9000。

• 504 Gateway Timeout：脚本执行超时或 FPM 资源不足。

  • 处置：适当提高 request_terminate_timeout（或 max_execution_time），增加 pm.max_children，并优化慢脚本。

• Primary script unknown：SCRIPT_FILENAME 未正确传递或 root 路径错误。

  • 处置：Nginx 配置中确保有 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; 且 root 正确。

• 进程池耗尽（pm.max_children reached）：并发超过进程上限。

  • 处置：提升 pm.max_children，或优化 pm 策略（如 ondemand → dynamic），并排查慢请求。

• Allowed memory exhausted：脚本内存超限。

  • 处置：提高 memory_limit，优化代码与查询。

• Permission denied（unix socket）：FPM 套接字权限/属主不匹配。

  • 处置：在 www.conf 中校正 listen.owner / listen.group / listen.mode，或改用 127.0.0.1:9000 并同步 Web 配置。

• 空白页：语法错误或错误未显示。

  • 处置：临时开启 display_errors = On 定位；用 php -l script.php 检查语法；查看 FPM 与 Web 错误日志。

四 高效分析命令与慢日志

• 实时观察与关键字过滤
  • 实时跟踪：tail -f /var/log/php-fpm/error.log | egrep -i “error|fatal|warning”
• 按时间窗口统计错误数
  • 示例（按日期统计）：
    • awk ‘/error/ {print $1, $2, $3}’ /var/log/php-fpm/error.log | sed ‘s/:/ /g’ | awk ‘{print $1}’ | sort | uniq -c
• 定位“谁在占用/阻塞”进程
  • 查看进程与连接：netstat -tulnp | grep 9000；结合 systemctl status php-fpm 与 journalctl 回溯异常退出。
• 慢日志分析（性能瓶颈定位）
  • 开启慢日志后，用：tail -f /var/log/php-fpm/www-slow.log 查看超过阈值的脚本及调用栈，优先优化 SQL/外部 HTTP/循环与内存 问题。

五 日志轮转与长期治理

• 使用 logrotate 管理 php-fpm.log 等日志文件大小与保留周期，避免单文件过大影响分析与磁盘空间。
• 建议接入集中式日志平台（如 ELK/Fluentd/Graylog）进行检索、可视化与告警，配合 Prometheus + Grafana 监控 FPM 进程与响应时延，实现主动发现与容量规划。