Spring Boot集成Keycloak后，如何控制自动生成Bean的加载顺序？

核心问题 #

Spring Boot自动配置的OAuth2相关Bean（如InMemoryClientRegistrationRepository、JwtDecoder）会在应用上下文初始化早期加载，此时自定义SSL配置尚未生效，导致访问HTTPS协议的Keycloak issuer URI时出现SSL验证失败。

解决方案 #

1. 调整配置类加载顺序（推荐） #

通过@AutoConfigureAfter注解，让OAuth2自动配置类在你的自定义SSL配置类之后加载：

首先定义自定义SSL配置类：

@Configuration
public class CustomSslConfig {
    @Bean
    public SSLContext sslContext() throws Exception {
        // 这里实现你的自定义SSL逻辑，比如加载信任自签名证书
        // 示例：信任所有证书（仅测试环境用，生产禁止）
        TrustManager[] trustAllCerts = new TrustManager[]{
            new X509TrustManager() {
                public X509Certificate[] getAcceptedIssuers() { return null; }
                public void checkClientTrusted(X509Certificate[] certs, String authType) {}
                public void checkServerTrusted(X509Certificate[] certs, String authType) {}
            }
        };
        SSLContext sslContext = SSLContext.getInstance("TLS");
        sslContext.init(null, trustAllCerts, new SecureRandom());
        return sslContext;
    }
}

然后创建配置类指定OAuth2自动配置的加载顺序：

@Configuration
@AutoConfigureAfter(CustomSslConfig.class)
@Import(OAuth2ResourceServerAutoConfiguration.class) // 资源服务器场景用这个
// @Import(OAuth2ClientAutoConfiguration.class) // 客户端登录场景用这个
public class OAuth2DelayedConfiguration {
    // 无需额外代码，仅用于调整加载顺序
}

2. 自定义Bean并指定依赖关系 #

如果需要更精准控制Bean初始化时机，可复用Spring Boot自动配置的OAuth2配置属性，手动创建Bean并通过@DependsOn指定依赖SSL配置：

资源服务器场景（JWT）

@Configuration
public class JwtDecoderConfiguration {
    @Bean
    @DependsOn("sslContext")
    public JwtDecoder jwtDecoder(OAuth2ResourceServerProperties properties) {
        // 复用配置文件中的issuer-uri配置，确保在SSL生效后初始化
        return JwtDecoders.fromIssuerLocation(properties.getJwt().getIssuerUri());
    }
}

客户端登录场景

@Configuration
public class ClientRegistrationConfiguration {
    @Bean
    @DependsOn("sslContext")
    public ClientRegistrationRepository clientRegistrationRepository(ClientRegistrationProperties properties) {
        // 复用配置文件中的客户端注册信息，避免手动重复配置
        List<ClientRegistration> registrations = properties.getRegistrations().values().stream()
                .map(ClientRegistration::withRegistrationId)
                .map(ClientRegistration.Builder::build)
                .collect(Collectors.toList());
        return new InMemoryClientRegistrationRepository(registrations);
    }
}

3. 补充说明 #

• 如果使用自签名证书，务必确保CustomSslConfig中正确配置了信任库，不要在生产环境使用“信任所有证书”的逻辑。
• 若你的SSL配置是通过server.ssl.*属性配置的（而非自定义Bean），可将@DependsOn的目标改为webServerFactoryCustomizer（Spring Boot自动创建的SSL相关Bean）。

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