Spring Boot微服务Docker Compose配置：确保其他服务晚于配置服务启动

你遇到的问题是Docker Compose的depends_on默认只保证容器启动，不保证容器内的服务完全就绪。要实现依赖服务仅在目标服务就绪后再启动，有两种标准解决方案：

方案一：使用Docker Compose健康检查（推荐） #

从Compose 3.0版本开始支持healthcheck和带条件的depends_on配置，能让依赖服务等待目标服务的健康检查通过后再启动。

修改你的docker-compose.yml，给config-service添加健康检查规则，同时更新discovery-service的依赖条件：

version: "3.9"
services:
  config-service:
    image: 'config-service:v1-BETA'
    build: '/opt/core/config-service/.'
    container_name: 'config-service'
    restart: always
    volumes:
      - db-data:/opt/core/data
    networks:
      - core-network
    ports:
      - "8088:8088"
    # 配置健康检查，调用Spring Boot Actuator健康端点
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8088/actuator/health"]
      interval: 5s        # 每5秒检查一次状态
      timeout: 3s         # 单次检查超时时间
      retries: 10         # 最多重试10次
      start_period: 10s   # 服务启动后10秒再开始检查

  discovery-service:
    image: 'discovery-service:v1-BETA'
    build: '/opt/core/discovery-service/.'
    container_name: 'discovery-service'
    depends_on:
      config-service:
        condition: service_healthy  # 等待config-service健康检查通过
    ports:
      - "8061:8061"
    restart: always
    volumes:
      - db-data:/opt/core/data
    networks:
      - core-network
    environment:
      - "SPRING_PROFILES_ACTIVE=prod"

volumes:
  db-data:

注意：需要确保你的Spring Boot服务开启了Actuator健康端点，在application.yml中添加配置：

management:
  endpoints:
    web:
      exposure:
        include: health

方案二：自定义启动脚本轮询 #

如果你的环境不支持带条件的depends_on，可以给discovery-service添加启动脚本，在启动应用前先轮询config-service的就绪状态，直到确认服务可用再启动自身。

1. 编写启动脚本wait-for-config.sh：

#!/bin/bash
# 轮询config-service的健康接口，直到返回成功
until curl -f http://config-service:8088/actuator/health; do
  echo "等待config-service就绪..."
  sleep 2
done

# 启动当前服务
java -jar /app/discovery-service.jar

2. 修改discovery-service的Dockerfile，将脚本复制到容器并设置为启动命令：

FROM openjdk:17-jdk-slim
WORKDIR /app
COPY target/discovery-service.jar .
COPY wait-for-config.sh .
RUN chmod +x wait-for-config.sh
CMD ["./wait-for-config.sh"]

3. 更新docker-compose.yml中的discovery-service配置（可保留基础depends_on确保容器启动顺序）：

discovery-service:
  # ...其他配置
  depends_on:
    - config-service

为什么sleep函数没用？ #

sleep是固定时长等待，无法准确判断服务实际初始化状态——比如服务启动慢时sleep时间不够，启动快时又会浪费时间。而健康检查或接口轮询是基于服务实际状态的判断，可靠性更高。

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