Docker环境下Laravel/Nginx出现ERR_EMPTY_RESPONSE问题求助

1. 检查容器内Laravel服务状态 #

• 进入Laravel容器：docker exec -it <laravel-container-name> bash
• 在容器内启动内置服务并测试：php artisan serve --host=0.0.0.0 --port=8000，随后执行curl http://localhost:8000，确认是否能返回正常响应
• 查看Laravel运行日志：cat storage/logs/laravel.log，排查是否有启动报错（如依赖缺失、配置错误、权限问题）

2. 验证端口映射与网络配置 #

• 确认docker-compose.yml中Laravel服务的端口映射格式正确，示例：

  services:
    laravel:
      ports:
        - "8000:8000" # 宿主机端口:容器内服务端口
      networks:
        - app-network # 确保与前端、Nginx服务处于同一自定义网络
  

• 检查容器内端口监听状态：执行netstat -tulpn（容器内需先安装net-tools），确认8000端口是否被php artisan serve或PHP-FPM/Nginx进程占用

3. Nginx反向代理配置检查（若使用Nginx托管Laravel） #

• 确保Nginx配置正确指向Laravel服务的容器地址，示例：

  server {
      listen 80;
      server_name localhost;
  
      location / {
          proxy_pass http://laravel:8000; # 此处"laravel"需与docker-compose中服务名一致
          proxy_set_header Host $host;
          proxy_set_header X-Real-IP $remote_addr;
          proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      }
  }
  

• 查看Nginx容器日志：docker logs <nginx-container-name>，排查是否有连接Laravel服务失败的报错信息

4. 文件权限与挂载检查 #

• 修复Laravel关键目录权限：在容器内执行chmod -R 775 storage bootstrap/cache和chown -R www-data:www-data storage bootstrap/cache（针对Nginx/PHP-FPM镜像）
• 确认docker-compose.yml中代码目录挂载路径正确，避免因文件缺失导致服务启动失败

5. 容器间网络连通性测试 #

• 从Nginx或React容器测试Laravel服务连通性：docker exec -it <nginx-container-name> ping laravel，确认服务名能正常解析且网络互通
• 直接访问容器IP测试：通过docker inspect <laravel-container-name>获取容器内部IP，执行curl http://<container-ip>:8000，判断问题出在端口映射还是服务本身

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