Docker Compose中Keycloak配置属性未覆盖致连接失败求助

核心问题定位 #

你的task-service启动时仍尝试用localhost连接Keycloak，核心原因是Docker环境变量命名错误，导致客户端配置里的Keycloak地址未被正确覆盖；同时depends_on仅保证容器启动顺序，不确保Keycloak服务就绪，加上Feign客户端未正确使用服务发现，引发连锁问题。

分步解决方案 #

1. 修正Keycloak环境变量命名 #

原docker-compose中，Keycloak客户端提供者的环境变量缺少CLIENT_前缀，无法覆盖spring.security.oauth2.client.provider.keycloak.issuer-uri配置。修改后的完整环境变量如下：

environment:
  - SPRING_DATA_MONGODB_URI=mongodb://mongodb:27017/task
  - EUREKA_CLIENT_SERVICE_URL_DEFAULTZONE=http://eureka-server:8090/eureka
  # 修正客户端提供者的环境变量命名
  - SPRING_SECURITY_OAUTH2_CLIENT_PROVIDER_KEYCLOAK_ISSUER_URI=http://keycloak:8180/auth/realms/task-realm
  - SPRING_SECURITY_OAUTH2_RESOURCESERVER_JWT_ISSUER_URI=http://keycloak:8180/auth/realms/task-realm
  - SPRING_SECURITY_OAUTH2_RESOURCESERVER_JWT_JWK_SET_URI=http://keycloak:8180/auth/realms/task-realm/protocol/openid-connect/certs
  - SPRING_RABBITMQ_HOST=rabbitmq
  - SPRING_RABBITMQ_VIRTUAL_HOST=vhost

2. 确保Keycloak服务就绪后启动task-service #

depends_on仅控制容器启动顺序，需给Keycloak添加健康检查，让Docker等待服务真正可用后再启动task-service：

第一步：给Keycloak容器添加健康检查

keycloak:
  image: quay.io/keycloak/keycloak:legacy # 替换为你使用的Keycloak版本
  container_name: keycloak
  ports:
    - '8180:8080'
  environment:
    - KEYCLOAK_USER=admin
    - KEYCLOAK_PASSWORD=admin
    - DB_VENDOR=h2
  healthcheck:
    test: ["CMD", "curl", "-f", "http://localhost:8080/auth/realms/task-realm"]
    interval: 10s
    timeout: 5s
    retries: 5
  networks:
    - task-management

第二步：修改task-service的depends_on条件

depends_on:
  eureka:
    condition: service_healthy
  mongodb:
    condition: service_healthy
  keycloak:
    condition: service_healthy
  rabbitmq:
    condition: service_healthy

3. 修复Open Feign Client服务发现问题 #

• 确保所有微服务都注册到Eureka，且Eureka容器名与环境变量中的eureka-server一致
• Feign客户端必须使用服务名调用，而非localhost，示例：

@FeignClient(name = "target-service") // 使用注册到Eureka的服务名
public interface TargetServiceClient {
    // 接口方法定义
}

• 确认所有服务都加入task-management网络，保证容器间可通过服务名通信

4. 可选：用Spring Profiles区分环境（简化配置） #

在application.yml中添加Docker专属配置，避免重复用环境变量覆盖：

spring:
  profiles:
    active: local
---
spring:
  config:
    activate:
      on-profile: docker
  data:
    mongodb:
      uri: mongodb://mongodb:27017/task
  security:
    oauth2:
      client:
        provider:
          keycloak:
            issuer-uri: http://keycloak:8180/auth/realms/task-realm
      resource-server:
        jwt:
          issuer-uri: http://keycloak:8180/auth/realms/task-realm
          jwk-set-uri: http://keycloak:8180/auth/realms/task-realm/protocol/openid-connect/certs
eureka:
  client:
    service-url:
      defaultZone: http://eureka-server:8090/eureka
spring:
  rabbitmq:
    host: rabbitmq
    virtual-host: vhost

然后在docker-compose中指定启用docker profile：

environment:
  - SPRING_PROFILES_ACTIVE=docker

内容的提问来源于stack exchange，提问作者Назар