PHP-FPM 必须先启动且监听地址与 Nginx fastcgi_pass 严格一致,否则出现 502;需检查服务状态、socket/TCP 配置、权限、日志以定位问题。

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。
实操建议:
立即学习“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免费学习笔记(深入)”;
- 若
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 以外的组。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 查 socket 文件权限:
ls -l /run/php/php8.1-fpm.sock,关注属主、属组和最后三位权限(如srw-rw----) - 确保 Nginx worker 用户(
ps aux | grep nginx看USER列)在 socket 所属组里,或直接改www.conf中:listen.owner = www-datalisten.group = www-datalisten.mode = 0660 - 改完重启:
sudo systemctl restart php8.1-fpm
测试 PHP 解析是否生效:别只靠 index.php 显示 phpinfo()
写个最简 index.php 放到网站根目录(如 /var/www/html/index.php),内容就一行:<?php echo 'OK'; ?>。这样比 phpinfo() 更快暴露路径、权限、语法等基础问题。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 确认 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 权限是否放行这三处。每改一步,都用对应命令验证状态,而不是堆砌配置再一起试。



















