Docker部署WordPress本地环境出现502 Bad Gateway错误求助

• 检查容器运行状态与连通性

  • 执行docker-compose ps确认WordPress和Nginx容器状态均为Up，若有容器未启动，查看对应容器日志排查启动失败原因
  • 进入Nginx容器，测试与WordPress容器的连通性：docker exec -it <nginx容器名> ping <docker-compose中wordpress服务名>，若无法连通，检查docker-compose的网络配置，确保两个容器处于同一自定义网络

• 核对Nginx反向代理配置

  • 打开nginx.conf，确认proxy_pass指向正确的WordPress容器地址，格式应为http://<wordpress服务名>:80（WordPress容器默认内部端口为80），禁止使用localhost/127.0.0.1（Nginx容器内的localhost指向自身，无法访问WordPress容器）
  • 确保配置了必要的请求头，示例配置：

    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    

• 查看容器日志定位错误

  • 查看Nginx错误日志：docker-compose logs nginx 或 docker exec -it <nginx容器名> cat /var/log/nginx/error.log，重点关注"connection refused"、"no upstream"类错误
  • 查看WordPress容器日志：docker-compose logs wordpress，确认WordPress服务是否正常启动、端口是否正常监听

• 检查宿主机端口映射

  • 确认docker-compose中Nginx的端口映射配置正确（如80:80），宿主机访问的端口需与映射端口一致
  • 执行netstat -tuln | grep <宿主机端口>，检查端口是否被其他进程占用

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