Spring授权服务器社交登录：FederatedIdentityIdTokenCustomizer未触发求助

1. 先确认依赖版本是否匹配 #

FederatedIdentityIdTokenCustomizer是Spring Authorization Server 1.1.0及以上版本才引入的特性，如果你用的是更早的版本（比如1.0.x），框架根本不会识别这个类。检查你的依赖配置：

<!-- Maven示例 -->
<dependency>
    <groupId>org.springframework.security</groupId>
    <artifactId>spring-security-oauth2-authorization-server</artifactId>
    <version>1.1.2</version>
</dependency>

2. 检查配置类的关联是否正确 #

光把FederatedIdentityIdTokenCustomizer注册成Bean没用，得在授权服务器的配置里把它关联到Token自定义链中。如果用的是新版DSL配置方式（1.0+推荐），要这么写：

@Bean
public SecurityFilterChain authorizationServerSecurityFilterChain(HttpSecurity http) throws Exception {
    OAuth2AuthorizationServerConfigurer authorizationServerConfigurer =
        new OAuth2AuthorizationServerConfigurer();
    
    authorizationServerConfigurer
        .oidc(oidc -> oidc
            .idTokenCustomizer(federatedIdentityIdTokenCustomizer) // 关键：在这里绑定自定义器
        );
    
    // 其他基础配置（比如端点权限、CSRF等）
    return http.apply(authorizationServerConfigurer).build();
}

如果是旧版AuthorizationServerConfigurer方式，要在endpoints配置中添加：

@Override
public void configure(AuthorizationServerEndpointsConfigurer endpoints) throws Exception {
    endpoints.tokenCustomizers(customizers -> 
        customizers.add(federatedIdentityIdTokenCustomizer)
    );
}

3. 验证社交登录流程是否走对了 #

FederatedIdentityIdTokenCustomizer只有在通过GitHub完成联邦认证，触发授权服务器签发自身Token的流程里才会被调用。确认你的流程是：

• 用户访问授权服务器的授权端点，选择GitHub登录
• 完成GitHub认证后，回调到授权服务器的回调地址
• 授权服务器此时会调用自定义器处理GitHub返回的用户信息，再签发自己的Token
  如果你的社交登录是直接在业务系统完成，没走授权服务器的联邦认证流程，这个自定义器肯定不会触发。

4. 检查自定义器Bean是否被正确加载 #

确保你的FederatedIdentityIdTokenCustomizer实现类所在的包被Spring组件扫描覆盖，或者已经通过@Bean显式注册：

@Bean
public FederatedIdentityIdTokenCustomizer federatedIdentityIdTokenCustomizer() {
    return (context) -> {
        // 加个日志或断点，确认是否进入这里
        OAuth2User oAuth2User = context.getPrincipal()
            .getAttribute(OAuth2AuthenticationToken.class.getName())
            .getPrincipal();
        context.getClaims().claim("github_login", oAuth2User.getAttribute("login"));
    };
}

可以通过Spring Boot Actuator的beans端点，或者调试断点确认这个Bean是否被实例化。

5. 排查是否有其他自定义器干扰 #

如果存在多个OAuth2TokenCustomizer，检查执行顺序是否正常，或者你的自定义器里有没有条件判断导致逻辑没执行。直接在自定义方法里加日志输出，确认是否进入了方法体。

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