Spring Boot OAuth2客户端无法连接Keycloak求助

以下是针对你的问题的具体排查步骤：

1. 网络连通性与地址解析问题 #

由于Spring Boot客户端运行在Docker外部，而Keycloak在容器内，直接使用localhost可能导致客户端无法正确访问容器内的Keycloak服务：

• 替换localhost为宿主机的实际IP地址（例如http://192.168.1.100:8080/realms/peaktrack），测试客户端机器能否通过浏览器或curl访问http://<宿主机IP>:8080/realms/peaktrack/.well-known/openid-configuration，确保返回完整的OpenID配置JSON。
• Windows/Mac环境下可尝试使用host.docker.internal代替localhost，该域名会自动解析到宿主机的内部IP；Linux环境下需手动配置Docker的主机网络映射或使用宿主机IP。
• 确认docker-compose中Keycloak的端口映射配置正确，例如：

  ports:
    - "8080:8080"
  

2. Keycloak领域的Frontend URL一致性校验 #

Spring Boot OAuth2客户端会严格校验Issuer URI与Keycloak返回的iss字段是否完全一致：

• 登录Keycloak管理控制台，进入peaktrack领域的Realm Settings -> General页面，检查Frontend URL配置。该值必须与Spring Boot客户端的issuer-uri完全匹配（包括协议、端口、路径）。
• 如果Frontend URL留空，Keycloak会根据请求的Host头生成iss字段，但容器内部的请求Host可能与客户端访问的宿主机Host不一致，导致校验失败，建议显式设置该值。

3. Spring Boot配置细节检查 #

• 确认build.gradle中已正确引入OAuth2客户端依赖：

  implementation 'org.springframework.boot:spring-boot-starter-oauth2-client'
  

• 核对application.yml的配置格式与内容：

  spring:
    security:
      oauth2:
        client:
          registration:
            keycloak:
              client-id: your-client-id
              client-secret: your-client-secret
              authorization-grant-type: authorization_code
              redirect-uri: "{baseUrl}/login/oauth2/code/{registrationId}"
          provider:
            keycloak:
              issuer-uri: http://<正确地址>/realms/peaktrack
  

  重点检查provider.keycloak.issuer-uri是否无拼写错误（如斜杠、领域名称），且与Keycloak的实际端点一致。

4. 防火墙与代理拦截排查 #

• 检查宿主机防火墙是否允许外部（客户端机器）访问8080端口，必要时临时关闭防火墙测试。
• 如果客户端机器处于代理环境下，需确认代理配置不会拦截对Keycloak端点的请求，或添加对应的例外规则。

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