如何解决Docker容器内NGINX的502 Bad Gateway错误

以下是针对问题的排查和修复步骤：

1. 修复PHP-FPM启动方式 #

Docker容器依赖前台进程维持运行，service php7.4-fpm start是后台启动逻辑，可能导致PHP-FPM进程未正常驻留或意外退出。改用前台启动命令：

修改Dockerfile的CMD指令：

CMD php-fpm7.4 -F & nginx -g 'daemon off;'

2. 验证PHP-FPM套接字路径与权限 #

NGINX返回502通常是无法连接到PHP-FPM服务，需检查两点：

• 确认套接字文件存在：进入容器执行ls /run/php/，查看是否有php7.4-fpm.sock，若不存在说明PHP-FPM未启动或配置错误。
• 修复套接字权限：NGINX以www-data用户运行，需确保该用户对套接字有读取权限。修改PHP-FPM的池配置文件/etc/php/7.4/fpm/pool.d/www.conf：

listen.owner = www-data
listen.group = www-data
listen.mode = 0660

在Dockerfile中添加修改命令：

RUN sed -i 's/listen.owner = .*/listen.owner = www-data/' /etc/php/7.4/fpm/pool.d/www.conf && \
    sed -i 's/listen.group = .*/listen.group = www-data/' /etc/php/7.4/fpm/pool.d/www.conf && \
    sed -i 's/listen.mode = .*/listen.mode = 0660/' /etc/php/7.4/fpm/pool.d/www.conf

3. 改用TCP连接替代Unix套接字（备选方案） #

如果套接字权限问题难以排查，可切换为TCP端口连接PHP-FPM：

• 修改nginx.conf中的fastcgi_pass：

fastcgi_pass 127.0.0.1:9000;

• 修改PHP-FPM的www.conf配置：

listen = 127.0.0.1:9000

在Dockerfile中添加对应修改命令即可。

4. 优化Dockerfile（可选） #

合并RUN指令减少镜像层数，同时清理冗余文件和缓存：

FROM ubuntu:20.04

RUN apt-get update && apt-get install -y --no-install-recommends \
    nginx \
    php-fpm php-mysql \
    wget && \
    wget https://wordpress.org/latest.tar.gz && \
    tar -xzf latest.tar.gz -C /var/www/html && \
    chown -R www-data:www-data /var/www/html/wordpress && \
    rm latest.tar.gz && \
    apt-get purge -y --auto-remove wget && \
    rm -rf /var/lib/apt/lists/*

COPY nginx.conf /etc/nginx/nginx.conf
COPY www.conf /etc/php/7.4/fpm/pool.d/www.conf # 若修改了PHP-FPM配置需添加

EXPOSE 80

CMD php-fpm7.4 -F & nginx -g 'daemon off;'

验证步骤 #

1. 构建镜像：docker build -t wp-nginx .
2. 运行容器：docker run -p 8080:80 wp-nginx
3. 查看容器日志：docker logs <容器ID>，排查PHP-FPM或NGINX的错误信息
4. 进入容器调试：docker exec -it <容器ID> bash，执行ps aux确认PHP-FPM进程状态，curl localhost测试NGINX解析PHP的情况

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