Ubuntu PHP-FPM的错误日志分析

Ubuntu下PHP-FPM错误日志分析与排查指南

一、定位PHP-FPM错误日志文件

PHP-FPM的错误日志默认存储路径因Ubuntu版本和PHP版本略有差异，常见位置包括：

• 通用路径：/var/log/php-fpm.log
• 版本化路径：/var/log/php7.x-fpm.log（如php7.4-fpm.log、php8.1-fpm.log，x为具体PHP版本号）
• 部分系统可能将错误日志拆分为/var/log/php-fpm/error.log或/var/log/php-fpm/www-error.log。
  可通过ls /var/log/php-fpm/命令查看目录下具体日志文件，或通过sudo find /var/log -name "*php-fpm*log"命令全局搜索。

二、查看与过滤错误日志

1. 实时监控最新错误

使用tail -f命令实时查看日志文件的新增内容，便于快速定位正在发生的错误：
sudo tail -f /var/log/php-fpm.log（替换为实际日志路径）。

2. 过滤特定错误类型

通过grep命令筛选关键错误，提升分析效率：

• 查找致命错误（程序终止执行）：sudo grep "PHP Fatal error" /var/log/php-fpm.log
• 查找警告信息（需关注但不终止）：sudo grep "PHP Warning" /var/log/php-fpm.log
• 查找通知信息（轻微问题）：sudo grep "PHP Notice" /var/log/php-fpm.log
• 查找进程崩溃（如信号终止）：sudo grep "child exited on signal" /var/log/php-fpm.log。

三、常见错误类型及解读

1. 致命错误（PHP Fatal error）

表现：脚本无法继续执行，常见于未定义函数、类或语法严重错误。
示例：PHP Fatal error: Uncaught Error: Call to undefined function foo() in /var/www/script.php:12
含义：脚本第12行调用了未定义的函数foo()，可能原因包括函数名拼写错误、未引入对应文件或扩展未加载。

2. 警告（PHP Warning）

表现：脚本继续执行但提示潜在问题，常见于文件/目录不存在、类型转换问题。
示例：PHP Warning: include(/var/www/inc/config.php): failed to open stream: No such file or directory in /var/www/index.php:5
含义：config.php文件不存在，需检查文件路径或权限。

3. 通知（PHP Notice）

表现：提示运行时小问题，通常不影响脚本执行，但可能隐藏逻辑错误。
示例：PHP Notice: Undefined variable: username in /var/www/login.php:20
含义：使用了未定义的变量$username，需检查变量初始化逻辑。

4. 进程崩溃（SIGBUS/Segmentation fault）

表现：日志中出现child exited on signal 7 (SIGBUS)或Segmentation fault，进程突然终止。
含义：通常因内存访问违规（如非法指针操作、扩展bug）导致，需检查代码或扩展兼容性。

5. 502 Bad Gateway

表现：Nginx/Apache返回502错误，常见于PHP-FPM未启动或通信失败。
含义：Web服务器无法连接到PHP-FPM进程，需检查PHP-FPM服务状态（systemctl status php7.x-fpm）及监听地址（listen配置）。

6. 504 Gateway Timeout

表现：请求超时报错，页面长时间无响应。
含义：PHP脚本执行时间超过request_terminate_timeout设置（默认30秒），或PHP-FPM进程数不足（pm.max_children过小）。

四、基于日志的常见故障排查

1. PHP-FPM未启动或崩溃

• 检查服务状态：sudo systemctl status php7.x-fpm（若未运行，执行sudo systemctl start php7.x-fpm）。
• 查看启动日志：若启动失败，通过journalctl -xe | grep php-fpm查看系统日志，定位具体原因（如配置错误、端口冲突）。

2. 端口/套接字冲突

表现：日志中出现Address already in use或socket already in use。
解决：

• 检查端口占用：sudo netstat -tulnp | grep 9000（默认端口9000）；
• 检查Unix socket占用：sudo lsof /run/php/php7.x-fpm.sock；
• 杀死占用进程（sudo kill -9 <PID>）或修改PHP-FPM监听地址（编辑/etc/php/7.x/fpm/pool.d/www.conf中的listen配置，如改为127.0.0.1:9001）。

3. 权限问题

表现：日志中出现Permission denied，常见于套接字文件或脚本目录无法访问。
解决：

• 确保套接字目录权限正确：sudo mkdir -p /run/php && sudo chown -R www-data:www-data /run/php（www-data为PHP-FPM默认用户）；
• 检查www.conf中的user/group设置，确保与Web服务器用户一致（如Nginx通常为www-data）。

4. 资源限制

表现：日志中出现Unable to create or open pid file或pm.max_children reached（进程池耗尽）。
解决：

• 增加进程限制：编辑/etc/php/7.x/fpm/php-fpm.conf，调整process.max（如设为200）；
• 优化pm配置：将pm = static改为pm = dynamic，并根据服务器内存调整pm.max_children（如每GB内存分配10-20个进程）。

5. 扩展加载失败

表现：日志中出现Unable to load dynamic library 'xxx.so'。
解决：

• 检查已安装模块：php -m；
• 确认php.ini中的扩展行未被注释（如extension=xxx.so）；
• 重新安装扩展：sudo apt-get install --reinstall php7.x-xxx（如php7.4-mysql）。

五、优化建议

• 开启慢日志：在www.conf中添加slowlog = /var/log/php-fpm/slow.log和request_slowlog_timeout = 5s（记录执行超过5秒的脚本），便于性能调优。
• 日志轮转：配置logrotate防止日志过大，编辑/etc/logrotate.d/php-fpm，添加如下内容：

  /var/log/php-fpm.log {
      daily
      rotate 7
      compress
      missingok
      notifempty
      create 640 www-data www-data
      sharedscripts
      postrotate
          systemctl reload php7.x-fpm > /dev/null 2>&1 || true
      endscript
  }
  

• 定期检查：通过tail -f或日志分析工具（如ELK、Graylog）实时监控错误日志，及时发现潜在问题。