首先确认PHP-FPM服务是否运行，检查Nginx的fastcgi_pass配置与PHP-FPM监听路径是否匹配，确保两者协议一致；接着验证PHP-FPM池配置中listen地址、权限设置正确，重启服务；然后排查文件权限及AppArmor限制；最后通过Nginx和PHP-FPM错误日志定位具体原因。

如果您在访问使用 Nginx 和 PHP-FPM 构建的网站时遇到“502 Bad Gateway”错误，这通常意味着 Nginx 无法成功将请求转发给 PHP-FPM 处理。该问题常见于 PHP-FPM 服务未运行、配置路径不匹配或进程崩溃等情况。

本文运行环境：Dell PowerEdge R750，Ubuntu 22.04

一、确认 PHP-FPM 服务是否正在运行

PHP-FPM 是处理 PHP 请求的核心服务，若其未启动或异常终止，Nginx 将无法与之通信，从而导致 502 错误。

1、打开终端并执行以下命令检查 PHP-FPM 服务状态：
sudo systemctl status php-fpm 或 sudo systemctl status php8.1-fpm（根据实际安装版本调整）

2、如果服务未运行，使用以下命令启动服务：
sudo systemctl start php8.1-fpm

3、设置服务开机自启以避免重启后再次失效：
sudo systemctl enable php8.1-fpm

二、检查 Nginx 配置中的 FastCGI 代理设置

Nginx 必须正确指向 PHP-FPM 监听的地址（IP:端口 或 Unix socket），否则请求无法被传递。

立即学习“PHP免费学习笔记（深入）”；

1、编辑站点配置文件，通常位于 /etc/nginx/sites-*ailable/default 或 /etc/nginx/conf.d/site.conf

2、查找 location ~ \.php$ 块，并确认 fastcgi_pass 的值是否与 PHP-FPM 实际监听方式一致：

若 PHP-FPM 使用 TCP 端口（如 127.0.0.1:9000），则应包含：
fastcgi_pass 127.0.0.1:9000;

若使用 Unix socket（更高效），则应为：
fastcgi_pass unix:/run/php/php8.1-fpm.sock;

3、保存更改后测试 Nginx 配置语法：
sudo nginx -t

4、重新加载 Nginx 使配置生效：
sudo systemctl reload nginx

三、验证 PHP-FPM 池配置文件

PHP-FPM 的每个站点可对应一个池（pool），其定义了监听路径、用户权限和进程数量等关键参数。

1、进入 PHP-FPM 池配置目录：
cd /etc/php/8.1/fpm/pool.d/

千鹿Pr助手

智能Pr插件，融入众多AI功能和海量素材

128 查看详情

2、编辑默认池文件 www.conf，检查 listen 指令是否与 Nginx 中 fastcgi_pass 所指定的路径完全一致。

例如，若 Nginx 使用 socket，则 listen 应为：
listen = /run/php/php8.1-fpm.sock

3、同时确认 socket 文件权限设置正确，确保 Nginx 进程用户（通常是 www-data）有读写权限：
listen.owner = www-data
listen.group = www-data
listen.mode = 0660

4、修改后重启 PHP-FPM 服务：
sudo systemctl restart php8.1-fpm

四、检查文件权限与 SELinux/AppArmor 限制

即使服务正常运行，安全模块或错误的文件权限也可能阻止 Nginx 访问 PHP-FPM 资源。

1、确认网站根目录归属正确，推荐设为 www-data 用户：
sudo chown -R www-data:www-data /var/www/html

2、修复目录和文件权限：
sudo find /var/www/html -type d -exec chmod 755 {} \;
sudo find /var/www/html -type f -exec chmod 644 {} \;

3、若系统启用 AppArmor（Ubuntu 默认启用），检查日志是否存在拒绝记录：
sudo dmesg | grep apparmor

4、如有必要，临时禁用 AppArmor 对 PHP-FPM 的策略进行测试：
sudo ln -s /etc/apparmor.d/usr.sbin.php-fpm /etc/apparmor.d/disable/usr.sbin.php-fpm
sudo apparmor_parser -R /etc/apparmor.d/usr.sbin.php-fpm

五、查看日志定位具体错误原因

通过分析 Nginx 和 PHP-FPM 的错误日志可以获取最直接的故障线索。

1、查看 Nginx 错误日志内容：
sudo tail -f /var/log/nginx/error.log

2、观察是否有类似 "connect() failed (111: Connection refused)" 或 "No such file or directory" 的提示。

3、查看 PHP-FPM 错误日志，通常位于：
sudo tail -f /var/log/php8.1-fpm.log

4、关注日志中是否出现 “Cannot get uid/gid”、“failed to parse configuration” 或子进程频繁崩溃的信息。

以上就是怎么解决Nginx 502 Bad Gateway错误_PHP-FPM配置问题排查教程的详细内容，更多请关注php中文网其它相关文章！

相关文章： C++如何跨平台操作文件和目录_C++17标准库std::filesystem的使用教程  mysql备份恢复性能优化_mysql备份恢复性能优化方法  必由学官网首页入口 必由学教师网页版登录指南  Spring Boot嵌入式服务器与J*a EE：功能支持深度解析  win11如何卸载Windows更新补丁 Win11解决更新导致系统不稳定的问题【修复】  深入理解Go语言中的指针类型：以*string为例  谷歌浏览器无痕模式怎么开 Chrome开启无痕浏览设置方法【教程】  sublime怎么设置启动时打开的窗口_sublime会话管理与热退出  C++如何打印当前代码行号与文件名_C++预定义宏FILE与LINE的使用  京东京造J1和网易云音乐氧气真无线有什么不同_国产电商蓝牙耳机音质对比  消息称三星明年 2 月正式发布 HBM4，与 SK 海力士同台竞技  J*a中实现Go语言select通道多路复用机制  Odoo 16：在表单视图中基于当前记录动态修改Tree视图属性  Lar*el Eloquent：基于关联关系是否存在进行父模型过滤与删除  深入理解与实现最大堆的Heapify过程：常见错误与修正  AO3官网镜像链接 Archive of Our Own同人文在线浏览  电脑IP地址怎么查 查看本机IP地址的几种方法  win11开机启动修复循环怎么办 Win11无法进入系统高级启动解决方法【修复】  在Go开发中优雅管理ListenAndServe进程：GoSublime集成方案  J*aScript数组对象转换：按指定键分组与值收集  Animex动漫社网入口地址 Animex动漫社网正版在线入口  Win10快速启动功能利弊分析 Win10开启或关闭快速启动教程【技巧】  微信群消息显示延迟如何解决 微信群消息刷新优化方法  2026年CSGO开箱网站推荐 CSGO开箱平台精选  如何在Promise链中优雅地中断后续then执行  为什么我的微信朋友圈看不到别人的更新_微信朋友圈更新显示异常解决方法  狙击外星人小游戏开始_狙击外星人小游戏立即开始  现代化 SciPy 一维插值：interp1d 的替代方案与最佳实践  126邮箱手机版登录官网2026_126手机邮箱免费入口最新  自动化J*a应用中GitHub CLI或REST API的认证与交互  在哪找SublimeJ远程工具_SFTP插件配置教程  J*a应用程序首次运行自动创建文件与目录的最佳实践  mysql如何设置表访问权限_mysql表访问权限配置  没有大陆身份证/银行卡如何实名微信？ 亲测有效的几种方法分享  Excel中VLOOKUP的第四个参数是干什么用的_Excel VLOOKUP第四参数作用解析  必由学官方平台入口 必由学在线课堂登录地址  Lar*el用户头像管理：实现图片缩放、存储与旧文件安全删除的最佳实践  响应式图片在网页设计中的正确实现方法  随机参数递归函数的基准调用次数与时间复杂度探究  J*aScript中正确使用querySelectorAll与复杂CSS选择器  如何在复杂的电商平台中优雅地管理共享资源并确保正确重定向，使用spryker-shop/resource-share-page模块助你一臂之力  可靠CSGO开箱平台解析 CSGO开箱网合集  Composer中的^和~符号代表什么_精通Composer版本号语义化约束  解决 Vaadin 8 中大文件音频播放与定位时出现的 IOException  Lar*el开发：如何在编辑界面正确预选数据库中的多选标签  c++如何实现单例设计模式_c++线程安全的单例模式写法  Yii2模块参数配置指南：正确声明与访问模块级配置  2306选座时如何选靠窗位置_12306选座靠窗座位查看方法解析  Win11怎么开启卓越性能模式 Win11电源选项启用高性能释放硬件潜力【方法】  LINUX的perf命令入门_LINUX官方性能分析工具的使用与解读