PHP-FPM与Nginx集成配置详解

本文深入解析了PHP-FPM与Nginx集成配置中最常见却极易被忽视的核心问题——502 Bad Gateway错误的根源并非Nginx本身配置失误，而往往源于PHP-FPM服务未启动、监听地址（socket或TCP）与Nginx的fastcgi_pass不严格匹配，以及Unix socket文件权限不足这三大关键环节；通过系统化的实操步骤——从检查服务状态、核对配置文件、修正权限设置到精准验证日志，手把手教你快速定位并彻底解决集成故障，让PHP动态站点稳定高效运行。

PHP-FPM 服务必须先启动，Nginx 才能代理过去

很多人配完 Nginx 却访问 502 Bad Gateway，根本原因不是 Nginx 配错了，而是 php-fpm 根本没在跑。Nginx 只负责把 PHP 请求转发给 php-fpm 的监听地址（比如 127.0.0.1:9000 或 /run/php/php8.1-fpm.sock），它不解析 PHP。

实操建议：

• 先运行 sudo systemctl status php8.1-fpm（版本号按你装的改），确认状态是 active (running)
• 如果没启动，用 sudo systemctl start php8.1-fpm 启动，并建议加自启：sudo systemctl enable php8.1-fpm
• 检查 php-fpm 实际监听方式：看配置文件 /etc/php/8.1/fpm/pool.d/www.conf 中的 listen 行——是 listen = /run/php/php8.1-fpm.sock（Unix socket）还是 listen = 127.0.0.1:9000（TCP）？Nginx 的 fastcgi_pass 必须和它严格一致

Nginx location ~ \\.php$ 块里 fastcgi\_pass 必须匹配 PHP-FPM 监听地址

这是最常出错的位置。Nginx 不会自动猜你要发给哪个 PHP-FPM 实例，fastcgi_pass 写错一个字符（比如少个斜杠、端口写成 9001、sock 路径权限不对）都会导致 502。

实操建议：

• 若 php-fpm 用 Unix socket（推荐，轻量）：fastcgi_pass unix:/run/php/php8.1-fpm.sock; —— 注意末尾分号，路径要和 www.conf 里 listen 完全一致
• 若用 TCP：fastcgi_pass 127.0.0.1:9000; —— 确保防火墙没拦本地回环，且 php-fpm 确实监听在该 IP:PORT
• 别漏掉 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;，否则 PHP 文件路径解析失败，报 No input file specified

PHP-FPM sock 文件权限问题：Nginx worker 进程必须有读写权限

用 Unix socket 时，Nginx 工作进程（通常是 www-data 用户）需要对 .sock 文件有读写权限。默认情况下，php-fpm 可能以 www-data 启动，但 socket 文件权限可能只给了 root 或 www-data:www-data 以外的组。

实操建议：

• 查 socket 文件权限：ls -l /run/php/php8.1-fpm.sock，关注属主、属组和最后三位权限（如 srw-rw----）
• 确保 Nginx worker 用户（ps aux | grep nginx 看 USER 列）在 socket 所属组里，或直接改 www.conf 中：
  listen.owner = www-data
listen.group = www-data
listen.mode = 0660
• 改完重启：sudo systemctl restart php8.1-fpm

测试 PHP 解析是否生效：别只靠 index.php 显示 phpinfo()

写个最简 index.php 放到网站根目录（如 /var/www/html/index.php），内容就一行：。这样比 phpinfo() 更快暴露路径、权限、语法等基础问题。

实操建议：

• 确认 Nginx 配置里 root 指向正确目录，且该目录下 index.php 可被 www-data 读取（chmod 644，chown -R www-data:www-data）
• 改完 Nginx 配置后必须执行 sudo nginx -t 测试语法，再 sudo systemctl reload nginx，不能只 reload 不测试
• 查看错误日志定位真实问题：sudo tail -f /var/log/nginx/error.log 和 sudo tail -f /var/log/php8.1-fpm.log，比反复刷新浏览器靠谱得多

真正卡住的地方往往不在 Nginx 配置本身，而在 PHP-FPM 是否运行、监听地址是否匹配、socket 权限是否放行这三处。每改一步，都用对应命令验证状态，而不是堆砌配置再一起试。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~