Docker环境下Nginx代理Laravel PHP-FPM容器报502 Bad Gateway问题排查

Connection reset by peer报错说明Nginx已经成功和php-fpm建立TCP连接，但php-fpm处理请求过程中异常崩溃，直接断开了连接，没有返回响应头。结合你给出的配置，常见原因如下：

• 代码目录权限不匹配：你通过volume将宿主机代码挂载到容器/var/www目录，容器内php-fpm以www-data用户（默认uid 33）运行，而宿主机挂载目录的所有者通常是普通用户（uid 1000），导致www-data没有读取代码文件的权限，php进程访问文件时报错崩溃
• Xdebug配置异常：你安装启用了Xdebug扩展，如果Xdebug的客户端地址、端口配置错误，无法连接调试客户端时，可能导致php进程直接崩溃
• Laravel依赖未安装：如果没有执行composer install生成vendor目录，Laravel启动时报致命错误，触发php-fpm子进程异常退出
• php扩展冲突：你安装的扩展较多，部分扩展版本不兼容也可能导致php进程异常终止
• 冗余配置隐患：你app-dev.dockerfile中将配置文件复制到了/etc/nginx/conf.d/目录，但app容器是php-fpm容器，没有安装Nginx也不存在这个目录，这两行属于无效配置，虽然不会直接导致报错，但可能引发后续配置混淆，建议删除。

1. 本地执行PHP脚本验证
   进入app容器执行以下命令，直接运行Laravel入口文件看是否有正常输出：

docker exec -it app php /var/www/public/index.php

如果执行报错，直接根据报错信息排查即可，可快速排除代码本身的问题。

2. 模拟FastCGI请求验证
   进入web容器，安装cgi-fcgi工具后模拟Nginx转发请求：

# 安装依赖
apt-get update && apt-get install libfcgi0ldbl -y
# 模拟请求
SCRIPT_FILENAME=/var/www/public/index.php REQUEST_METHOD=GET cgi-fcgi -bind -connect app:9000

如果能返回正常的HTTP响应内容，说明php-fpm接收处理请求正常，问题出在Nginx配置或者其他环节；如果报错，说明php-fpm本身处理逻辑有问题。

3. 查看php-fpm运行日志
   进入app容器查看php-fpm主日志，看是否有子进程崩溃的记录：

cat /usr/local/var/log/php-fpm.log

你也可以在xlaravel.pool.conf中新增以下配置，开启php错误日志输出：

php_admin_value[error_log] = /var/log/php-error.log
php_admin_flag[log_errors] = on

重启容器后查看/var/log/php-error.log的具体报错即可定位问题。

1. 先验证权限问题：在app容器中执行以下命令，确认www-data用户可以读取代码文件

su - www-data -s /bin/bash -c "cat /var/www/public/index.php"

如果报权限错误，要么修改宿主机代码目录权限，要么在Dockerfile中新增命令将容器内www-data的uid修改为和宿主机挂载目录所有者一致：

RUN usermod -u 1000 www-data && groupmod -g 1000 www-data

2. 暂时禁用Xdebug扩展，重启app容器测试是否恢复，如果恢复正常说明Xdebug配置有误，修正配置即可
3. 确认已经执行过composer install，/var/www/vendor目录存在，且.env配置文件正确

内容的提问来源于stack exchange，提问作者atoms