Ubuntu 下 PHP-FPM 启动失败的排查与修复
一、快速定位
- 查看服务状态与系统日志，获取明确报错关键词：
- 查看状态：sudo systemctl status php7.x-fpm（将 7.x 替换为你的实际版本，如 7.4、8.1、8.3）
- 查看详细日志：sudo journalctl -xeu php7.x-fpm
- 查看 PHP-FPM 自身错误日志（常见路径，按实际版本调整）：
- /var/log/php-fpm.log
- /var/log/php7.x-fpm.log
- 实时跟踪：sudo tail -f /var/log/php7.x-fpm.log
- 校验配置语法并定位包含文件错误：
- 主配置校验：sudo php-fpm7.x -t
- 若提示包含目录无匹配配置，说明 /etc/php/7.x/fpm/pool.d/*.conf 缺失，需恢复默认 www.conf 等池配置。
二、常见原因与对应修复
-
配置文件语法错误或池配置缺失
- 现象：状态报错含 “ERROR: failed to post process the configuration” 或 “No pool defined”。
- 处理：
- 校验：sudo php-fpm7.x -t
- 恢复默认池配置（以 7.4 为例）：
- 若 /etc/php/7.4/fpm/pool.d/www.conf 丢失：
sudo cp /etc/php/7.4/fpm/pool.d/www.conf.default /etc/php/7.4/fpm/pool.d/www.conf
- 重启：sudo systemctl restart php7.4-fpm。
-
监听地址冲突或端口被占用
- 现象：状态或日志含 “Address already in use” 或 “failed to bind listening socket”。
- 处理：
- 检查端口占用（示例端口 9000）：sudo ss -tulpen | grep 9000
- 停止占用进程或修改 /etc/php/7.x/fpm/pool.d/www.conf 中的 listen（如改为 127.0.0.1:9001 或 /run/php/php7.x-fpm.sock），再重启服务。
-
权限与目录问题（Unix 套接字或日志目录）
- 现象：日志含 “Permission denied”，或 /var/log/php7.x-fpm.log 无法写入。
- 处理：
- 创建日志目录并授权（以 7.4 为例）：
sudo mkdir -p /var/log/php7.4-fpm
sudo chown www-data:www-data /var/log/php7.4-fpm
sudo chmod 0755 /var/log/php7.4-fpm
- 确保 /run/php/ 目录存在且可写（多数发行版由 php-fpm 包自带 tmpfiles 配置，如缺失可手动创建并授权）。
- 若 Nginx/Apache 报 “connect() to unix:/run/php/php7.4-fpm.sock failed (13: Permission denied)”，在 /etc/php/7.4/fpm/pool.d/www.conf 调整：
- 临时方案：listen.owner = www-data; listen.group = www-data; listen.mode = 0666
- 推荐方案：保持 0660，并确保 Nginx/Apache 工作进程用户属于 www-data 组。
-
服务未安装或服务名不匹配
- 现象：php-fpm.service not found 或 systemctl 找不到对应单元。
- 处理：
- 安装对应版本包（以 7.4 为例）：sudo apt-get install php7.4-fpm
- 编译安装场景需自行注册服务（如使用 update-rc.d 或创建 systemd unit），或改用发行版包管理安装以获得标准单元文件。
三、配置与联动检查
- 核对 PHP-FPM 池配置 /etc/php/7.x/fpm/pool.d/www.conf
- 关键项：listen（套接字或端口）、user/group（如 www-data）、pm.max_children、pm.start_servers、pm.min_spare_servers、pm.max_spare_servers、request_terminate_timeout、日志路径等。
- 与 Web 服务器联动（以常见场景为例）
- Nginx：确保 fastcgi_pass 与 FPM 的 listen 一致（如 fastcgi_pass unix:/run/php/php7.4-fpm.sock; 或 fastcgi_pass 127.0.0.1:9000;）。
- Apache（启用 proxy_fcgi）：确认 ProxyPassMatch 指向正确的 FPM 套接字或端口，且模块 proxy 与 proxy_fcgi 已启用。
- 修改后务必执行：sudo php-fpm7.x -t && sudo systemctl restart php7.x-fpm，并再次查看状态与日志确认无新错误。
四、一键排查清单
- 确认版本并查看状态与日志：sudo systemctl status php7.x-fpm、sudo journalctl -xeu php7.x-fpm、sudo tail -f /var/log/php7.x-fpm.log
- 校验配置：sudo php-fpm7.x -t
- 检查端口/套接字占用：sudo ss -tulpen | grep 9000（或对应端口/套接字）
- 检查日志目录权限（以 7.4 为例）：ls -ld /var/log/php7.4-fpm /run/php
- 核对 /etc/php/7.x/fpm/pool.d/www.conf 的 listen、user、group、pm.*、日志路径
- 核对 Nginx/Apache 的 fastcgi_pass/ProxyPassMatch 与 FPM 的 listen 一致
- 重启并复核：sudo systemctl restart php7.x-fpm && sudo systemctl status php7.x-fpm