Spring Boot微服务Docker Compose healthcheck失效，请求排查解决

嘿，我来帮你搞定这个问题！既然本地手动按顺序启动一切正常，但用docker-compose up时依赖管控出问题，大概率是healthcheck配置不够精准或者依赖启动的逻辑没到位。我给你几个核心调整方向：

1. 给核心服务补全精准的Healthcheck配置 #

首先要确保每个被依赖的服务（比如Eureka、Config Server）的healthcheck能准确判断服务是否真的就绪，而不是仅仅容器启动。比如Spring Boot服务的healthcheck命令要指向容器内的端口，而非宿主机端口：

config-server:
  build: ./config-server
  ports:
    - "8888:8888"
  healthcheck:
    test: ["CMD", "curl", "-f", "http://localhost:8888/actuator/health"]
    interval: 10s       # 每10秒检查一次
    timeout: 5s         # 超时时间5秒
    retries: 5          # 重试5次失败则标记为不健康
    start_period: 30s   # 启动后30秒再开始检查，给Spring Boot足够初始化时间

eureka-server:
  build: ./eureka-server
  ports:
    - "8761:8761"
  healthcheck:
    test: ["CMD", "curl", "-f", "http://localhost:8761/actuator/health"]
    interval: 10s
    timeout: 5s
    retries: 5
    start_period: 25s

2. 用depends_on结合service_healthy控制启动顺序 #

Docker Compose默认的depends_on只保证容器启动，不关心服务是否就绪。必须加上condition: service_healthy，让依赖服务等被依赖服务健康检查通过后再启动。比如你的Visits和Customers服务依赖Eureka和Config Server，配置应该这样写：

visits-service:
  build: ./visits-service
  ports:
    - "8300:8300"
  depends_on:
    config-server:
      condition: service_healthy
    eureka-server:
      condition: service_healthy
  healthcheck:
    test: ["CMD", "curl", "-f", "http://localhost:8300/actuator/health"]
    interval: 10s
    timeout: 5s
    retries: 5
    start_period: 35s

customers-service:
  build: ./customers-service
  ports:
    - "8100:8100"
  depends_on:
    config-server:
      condition: service_healthy
    eureka-server:
      condition: service_healthy
  healthcheck:
    test: ["CMD", "curl", "-f", "http://localhost:8100/actuator/health"]
    interval: 10s
    timeout: 5s
    retries: 5
    start_period: 35s

注意：如果你用的Docker Compose版本低于3.8，condition参数不支持，记得把docker-compose.yml开头的版本号升级到3.9或更高：version: '3.9'

3. 修正服务内的依赖地址配置 #

容器内不能用localhost访问其他服务，要改用Docker Compose的服务名（比如eureka-server、config-server），因为Docker会自动把服务名解析为对应容器的IP。比如：

• Eureka客户端配置：eureka.client.serviceUrl.defaultZone=http://eureka-server:8761/eureka/
• Config Server配置：spring.cloud.config.uri=http://config-server:8888/

如果还是用localhost，服务会尝试访问容器自身，导致注册或配置拉取失败，即使healthcheck过了也会出问题。

4. 补全缺失架构部分的健康检查 #

你提到部分架构内容缺失，如果还有数据库、Redis这类中间件，也要给它们配置healthcheck，比如MySQL：

mysql-db:
  image: mysql:8.0
  environment:
    MYSQL_ROOT_PASSWORD: root
  healthcheck:
    test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-uroot", "-proot"]
    interval: 10s
    timeout: 5s
    retries: 3
    start_period: 20s

然后依赖这个数据库的服务也要在depends_on里加上condition: service_healthy。

按照这些调整后，重新执行docker-compose up，服务应该会按依赖顺序，等前置服务健康检查通过后再启动了。

内容的提问来源于stack exchange，提问作者Erick De Miranda Oliveira