Docker Compose批量启动时Nginx挂载异常致容器重启故障

核心原因 #

从根目录通过COMPOSE_FILE批量启动时，相对路径的基准是根目录，而sale-service的docker-compose.yml中配置的nginx挂载路径是基于自身目录的，这会导致实际挂载的不是sale-service下的nginx配置文件，而是根目录下不存在的路径（或错误加载了core-service的配置），最终nginx配置里的core_php上游主机无法解析，同时端口配置可能因挂载错误失效，引发持续重启。

另外，批量启动时服务启动顺序无依赖控制，sale_nginx可能先于core_php启动，也会导致临时的主机解析失败，但持续重启说明核心问题是配置文件挂载错误。

解决方案 #

1. 修正挂载路径为基于项目根的相对路径 #

修改sale-service/docker-compose.yml中的nginx挂载配置，把原本基于sale-service目录的相对路径，改成基于项目根目录的相对路径：

# sale-service/docker-compose.yml 中sale_nginx的volumes配置
volumes:
  # 原写法（基于sale-service目录）：
  # - ./dockerfiles/nginx/conf.d:/etc/nginx/conf.d
  # 修改为基于根目录的相对路径：
  - ./sale-service/dockerfiles/nginx/conf.d:/etc/nginx/conf.d
  - ./sale-service/dockerfiles/nginx/html:/usr/share/nginx/html

这样无论从哪个目录启动，都能正确挂载到sale-service下的nginx配置文件，避免加载错误的配置。

2. 显式配置服务依赖与统一网络 #

确保core_php和sale_nginx处于同一网络，并且sale_nginx等待core_php就绪后再启动：

• 在所有服务的docker-compose.yml中显式指定同一个自定义网络：

# 每个服务的docker-compose.yml顶部添加
networks:
  app-network:
    external: false

# 每个服务的service配置中加入网络关联
services:
  sale_nginx:
    # ...其他配置
    networks:
      - app-network
    depends_on:
      - sale_php
      - core_php # 显式依赖core_php，确保启动顺序

如果core_php启动较慢，可添加健康检查保证服务就绪后再启动sale_nginx：

services:
  core_php:
    # ...其他配置
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:9000"] # 根据PHP-FPM实际端口调整
      interval: 5s
      timeout: 5s
      retries: 3
  sale_nginx:
    depends_on:
      core_php:
        condition: service_healthy

3. 检查.env中的COMPOSE_FILE配置 #

确保根目录.env文件里的COMPOSE_FILE正确包含所有服务的配置文件路径：

# .env文件示例
COMPOSE_FILE=core-service/docker-compose.yml:sale-service/docker-compose.yml
# 13个服务依次追加，用冒号分隔路径

4. 验证nginx配置文件 #

确认sale-service下的nginx配置文件中，core_php的引用正确，且core-service的docker-compose.yml中服务名称确实为core_php。

验证步骤 #

1. 停止所有容器：docker compose down
2. 清理残留挂载缓存（可选）：docker volume prune
3. 从根目录重新启动：docker compose up -d
4. 查看sale_nginx日志：docker compose logs sale_nginx，确认解析错误是否消失

内容的提问来源于stack exchange，提问作者M a m a D