Docker部署Eureka遇启动异常及健康检查配置问题求助

问题1：springcloud/eureka镜像启动时出现副本不可用异常 #

单节点部署时，必须明确禁用Eureka的自我注册和副本拉取，同时关闭自我保护机制，确保环境变量正确映射到Spring Boot参数：

完整docker-compose示例：

version: '3.8'
services:
  eureka-server:
    image: springcloud/eureka:2.2.5.RELEASE # 指定稳定版本，避免latest镜像的兼容性问题
    container_name: eureka-server
    environment:
      - EUREKA_INSTANCE_HOSTNAME=eureka-server
      - EUREKA_CLIENT_REGISTER_WITH_EUREKA=false # 禁止自我注册
      - EUREKA_CLIENT_FETCH_REGISTRY=false # 禁止拉取副本注册信息
      - EUREKA_SERVER_ENABLE_SELF_PRESERVATION=false # 关闭自我保护
    ports:
      - "8761:8761"

如果仍出现异常，检查镜像版本是否与你的Spring Cloud版本兼容，比如Spring Cloud Hoxton对应Eureka 2.2.x版本，避免跨版本使用。

问题2：自制nadchel/eureka-server镜像健康检查失败 #

健康检查失败通常是以下三个原因之一，逐一排查：

1. 容器内未安装curl工具 #

自制镜像如果基于轻量级基础镜像（如openjdk:11-jre-slim或alpine），默认没有curl，导致健康检查命令执行失败。修改Dockerfile添加curl：

# 以Debian/Ubuntu系基础镜像为例
FROM openjdk:11-jre-slim
RUN apt-get update && apt-get install -y --no-install-recommends curl \
    && rm -rf /var/lib/apt/lists/* # 清理缓存减小镜像体积

COPY target/eureka-server.jar /app.jar
ENTRYPOINT ["java", "-jar", "/app.jar"]

如果是Alpine基础镜像，替换为：

RUN apk add --no-cache curl

2. 健康检查端点未正确配置 #

确保你的Eureka应用已引入Spring Boot Actuator依赖，并开放健康端点：
在pom.xml（Maven）中添加：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

在application.yml中配置端点：

management:
  endpoints:
    web:
      exposure:
        include: health # 开放健康端点
  endpoint:
    health:
      show-details: always # 可选，方便调试

然后修改docker-compose中的健康检查配置，使用正确的Actuator端点：

services:
  eureka-server:
    image: nadchel/eureka-server
    container_name: eureka-server
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8761/actuator/health"]
      interval: 30s # 每30秒检查一次
      timeout: 10s # 超时时间10秒
      retries: 3 # 失败3次标记为不健康
      start_period: 60s # 启动后60秒再开始检查，给Eureka足够启动时间
    ports:
      - "8761:8761"

3. 应用绑定地址或端口不匹配 #

如果你的Eureka应用启动时绑定的不是localhost，而是0.0.0.0或其他地址，调整curl命令中的地址为http://0.0.0.0:8761/actuator/health；如果端口不是8761，同步修改端口号即可。

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