php-fpm在Linux上的错误日志如何分析

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

一定位日志与关键配置

常见日志路径
- Ubuntu/Debian：日志通常在 /var/log/php-fpm/error.log；主进程/系统日志可用 journalctl -u php{version}-fpm 查看。
- CentOS/RHEL：常见在 /var/log/php-fpm/error.log，也可能在 /var/log/php/ 或 /var/log/httpd/（使用 mod_php 时）。
核心配置位置
- FPM 池配置：/etc/php/{version}/fpm/pool.d/www.conf（设置日志路径、级别、慢日志等）。
- PHP 运行时：php.ini（控制应用层错误记录）。
建议的关键配置示例
- FPM 池（按需调整）：
  - error_log = /var/log/php-fpm/error.log
  - log_level = notice（调试期可改为 debug，上线后改回）
  - catch_workers_output = yes（便于捕获脚本输出与错误）
  - 慢日志：slowlog = /var/log/php-fpm/slow.log，request_slowlog_timeout = 5s
- php.ini（生产建议）：
  - error_reporting = E_ALL
  - log_errors = On
  - error_log = /var/log/php_errors.log
  - display_errors = Off（避免泄露敏感信息）
使配置生效
- 语法检查：php-fpm -t
- 重启服务：systemctl restart php{version}-fpm
  以上路径与配置在不同发行版可能略有差异，请以实际环境与配置为准。

二快速排查流程

实时观察与关键字筛选
- 实时看错误：tail -f /var/log/php-fpm/error.log
- 关键字定位：grep -i “error|fatal|exception” /var/log/php-fpm/error.log
- 按时间窗口统计（示例以空格分隔的“日时:分:秒”开头日志）：
  - 提取时间并筛选区间：awk ‘/error/ {print $1,$2,$3}’ /var/log/php-fpm/error.log | sed ‘s/:/ /g’ | awk ‘$1" “$2 >= “2025 11 22 10” && $1” "$2 <= “2025 11 22 12” {print}’
关联 Web 服务器日志
- Nginx 错误：tail -f /var/log/nginx/error.log
- 当出现 502/504 等网关错误时，同时比对 FPM 与 Nginx 的错误时间点与请求 URI。
进程与连通性检查
- 进程状态：systemctl status php{version}-fpm
- 端口/监听：ss -lntp | grep 9000 或 netstat -tulnp | grep 9000
- FPM 配置监听与 Web 配置（如 listen = 127.0.0.1:9000 或 /run/php/php{version}-fpm.sock）需一致。
语法与权限
- 脚本语法：php -l /var/www/html/index.php
- 文件权限：确保 PHP-FPM 运行用户（如 www-data）对代码与目录有读/执行权限；核对 listen.owner/listen.group。
  以上流程覆盖定位、筛选、关联与验证四个环节，可快速缩小问题范围。

三常见错误模式与处置要点

现象	日志线索	处置要点
502 Bad Gateway	FPM 未启动/崩溃；Nginx 与 FPM 通信失败	检查进程与端口/套接字；核对 Nginx fastcgi_pass 与 FPM listen 一致
504 Gateway Timeout	脚本执行超时；进程池资源不足	调整 request_terminate_timeout；增加 pm.max_children；优化慢脚本
Primary script unknown	SCRIPT_FILENAME 传递错误	Nginx 配置确保 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; 且 root 正确
进程池耗尽	日志提示 pm.max_children reached	提升 pm.max_children；结合内存与性能选择 dynamic/ondemand；优化应用
Allowed memory exhausted	E_ERROR: Allowed memory size of X bytes exhausted	提升 memory_limit；优化代码与查询
空白页	无输出且应用无日志	临时开启 display_errors = On 复现；检查语法与 FPM 错误日志
FPM 无法启动	配置语法错误；端口冲突	执行 php-fpm -t；排查端口占用与配置项冲突
以上模式与处置要点可覆盖大多数线上问题，配合日志时间点与请求上下文能更快定位根因。

四慢日志与性能瓶颈定位

启用慢日志
- 在 pool.d/www.conf 中设置：
  - slowlog = /var/log/php-fpm/slow.log
  - request_slowlog_timeout = 5s（记录超过 5 秒的请求栈）
分析方法
- 查看最耗时请求：tail -n 100 /var/log/php-fpm/slow.log | less
- 结合时间戳与 URI/脚本文件 定位瓶颈函数、SQL 或外部接口调用。
优化方向
- 数据库慢查询优化、索引与连接复用；减少阻塞 I/O；拆分大任务；必要时调整 pm 策略与进程数。
  慢日志是发现性能瓶颈的最直接证据来源，建议长期开启并定期复盘。

五日志轮转与长期治理

使用 logrotate 对 php-fpm.log / slow.log 做按日/按大小切割，避免单文件过大影响分析与磁盘占用。
集中化与可视化
- 小规模可用 ELK（Elasticsearch/Logstash/Kibana）/Graylog 做检索与看板；中大型建议引入 Fluentd 统一采集。
监控与告警
- 基于日志关键字与指标（如 5xx 比例、慢请求数、进程池占用）设置 Prometheus + Grafana 告警，做到问题前置发现。
  完善的日志治理能显著降低排障成本并提升稳定性。

最新问答