Docker-Compose中Spring Boot对接Keycloak启动连接拒绝问题求助

一、服务启动顺序不匹配 #

客户端服务启动时，iam-service容器虽已启动，但Spring Boot应用尚未完成初始化（OpenID配置端点未就绪），导致连接被拒绝。

• 调试步骤：
  • 修改docker-compose.yml，给iam-service添加健康检查配置，让客户端服务依赖其健康状态而非仅容器启动：

    services:
      iam-service:
        # 其他配置...
        healthcheck:
          test: ["CMD", "curl", "-f", "http://localhost:8080/realms/OptionAdvisor/.well-known/openid-configuration"]
          interval: 10s
          timeout: 5s
          retries: 5
      ranking-service:
        # 其他配置...
        depends_on:
          iam-service:
            condition: service_healthy
    

  • 临时验证：手动先启动iam-service，等待日志输出Tomcat started on port(s): 8080 (http)或访问其OpenID配置端点确认就绪后，再启动客户端服务。

二、容器网络瞬时异常 #

Docker Compose默认网络下，容器启动初期可能存在DNS解析延迟或网络连通性短暂问题，导致客户端启动时无法解析iam-service。

• 调试步骤：
  • 在客户端服务的启动命令前添加延迟（比如sleep 30 && java -jar app.jar），规避启动初期的网络不稳定。
  • 客户端启动失败后，进入容器执行以下命令验证当前网络状态：

    nslookup iam-service  # 检查服务名解析
    wget http://iam-service:8080/realms/OptionAdvisor/.well-known/openid-configuration  # 检查端点连通性
    

三、OAuth客户端配置错误 #

客户端配置中OpenID端点地址可能存在拼写错误、环境配置覆盖或加载优先级问题。

• 调试步骤：
  • 核对ranking-service的application.yml和application-dev.yml，确认spring.security.oauth2.client.provider.*.issuer-uri准确设置为http://iam-service:8080/realms/OptionAdvisor，无大小写错误、多余空格或路径缺失。
  • 查看客户端启动日志，搜索issuer-uri关键字，确认实际加载的配置值是否符合预期（Spring Boot会打印加载的配置文件及具体参数）。
  • 在客户端容器内直接请求完整的OpenID配置端点：curl http://iam-service:8080/realms/OptionAdvisor/.well-known/openid-configuration，验证是否能获取到标准的OpenID配置JSON。

四、iam-service端口监听限制 #

iam-service可能仅绑定了localhost（127.0.0.1）端口，导致容器内部无法通过服务名访问（容器内部的localhost指向自身，而非iam-service容器）。

• 调试步骤：
  • 检查iam-service的配置文件，确认server.address设置为0.0.0.0（允许所有地址监听），server.port为8080。
  • 进入iam-service容器，执行netstat -tulpn，确认8080端口监听在0.0.0.0而非仅127.0.0.1。

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