Spring Security OAuth2 v5升级后出现NoSuchBeanDefinitionException: 'org.springframework.security.oauth2.jwt.JwtDecoder'问题排查

这个启动警告的核心原因非常明确：当你使用Spring Security 5.x的.oauth2ResourceServer().jwt()配置时，框架必须依赖一个JwtDecoder类型的Bean来完成JWT令牌的解析工作，但你的配置里并没有定义这个Bean，所以容器启动时找不到它，直接导致上下文初始化失败。

解决方案：添加JwtDecoder Bean #

你需要根据授权服务器的实际配置，选择合适的方式创建JwtDecoder Bean，下面是两种最常见的场景：

场景1：授权服务器提供JWK Set URI（推荐，适用于标准OAuth2服务器）

如果你的授权服务器（比如Keycloak、Spring Authorization Server或云厂商身份服务）暴露了JWK（JSON Web Key）集合端点，可以直接用官方工具类快速创建解码器：

@Bean
public JwtDecoder jwtDecoder() {
    // 替换为你的授权服务器Issuer地址，框架会自动发现JWK URI
    return JwtDecoders.fromIssuerLocation("https://your-auth-server-domain/oauth2/issuer");
    
    // 若明确知道JWK URI，也可以直接指定：
    // return JwtDecoders.fromJwkSetUri("https://your-auth-server-domain/oauth2/issuer/v1/keys");
}

场景2：使用本地公钥解析JWT（适用于自签名或本地部署的授权服务器）

如果你的JWT是用本地生成的RSA密钥签名的，可以加载本地公钥来创建解码器：

import org.springframework.core.io.ClassPathResource;
import org.springframework.security.oauth2.jwt.NimbusJwtDecoder;
import java.nio.file.Files;
import java.security.KeyFactory;
import java.security.PublicKey;
import java.security.spec.X509EncodedKeySpec;
import java.util.Base64;

@Bean
public JwtDecoder jwtDecoder() throws Exception {
    // 从classpath加载公钥文件（示例为public-key.pem）
    ClassPathResource publicKeyResource = new ClassPathResource("public-key.pem");
    String publicKeyContent = new String(Files.readAllBytes(publicKeyResource.getFile().toPath()));
    
    // 去除PEM格式的头部、尾部和空白字符，解析为RSAPublicKey
    String publicKeyPem = publicKeyContent.replaceAll("-----BEGIN PUBLIC KEY-----", "")
                                          .replaceAll("-----END PUBLIC KEY-----", "")
                                          .replaceAll("\\s", "");
    PublicKey publicKey = KeyFactory.getInstance("RSA")
            .generatePublic(new X509EncodedKeySpec(Base64.getDecoder().decode(publicKeyPem)));
    
    return NimbusJwtDecoder.withPublicKey((java.security.interfaces.RSAPublicKey) publicKey).build();
}

关于依赖的说明 #

你当前的依赖配置完全符合要求：

• spring-security-oauth2-resource-server：核心资源服务器支持
• spring-security-oauth2-core：OAuth2核心模型定义
• spring-security-oauth2-jose：JOSE/JWT相关工具类
• nimbus-jose-jwt：Spring Security底层依赖的JWT解析库

这些依赖和你的Spring Boot 2.5.3、Spring Security 5.5.1版本完全匹配，不需要额外添加或修改。

额外提示：自定义转换器的优化 #

如果你希望自定义转换器保留默认的权限解析逻辑，再叠加自定义逻辑，可以在CustomTokenAuthenticationConverter中注入默认的JwtGrantedAuthoritiesConverter：

public class CustomTokenAuthenticationConverter implements Converter<Jwt, AbstractAuthenticationToken> {
    private final JwtGrantedAuthoritiesConverter defaultGrantedAuthoritiesConverter;

    public CustomTokenAuthenticationConverter(JwtGrantedAuthoritiesConverter defaultGrantedAuthoritiesConverter) {
        this.defaultGrantedAuthoritiesConverter = defaultGrantedAuthoritiesConverter;
    }

    @Override
    public AbstractAuthenticationToken convert(Jwt jwt) {
        // 先调用默认转换器获取基础权限
        Collection<GrantedAuthority> authorities = defaultGrantedAuthoritiesConverter.convert(jwt);
        // 添加你的自定义权限解析逻辑
        // ...
        return new JwtAuthenticationToken(jwt, authorities);
    }
}

然后修改配置类中的Bean定义，注入默认转换器：

@Bean
public CustomTokenAuthenticationConverter customTokenAuthenticationConverter(JwtGrantedAuthoritiesConverter jwtGrantedAuthoritiesConverter) {
    return new CustomTokenAuthenticationConverter(jwtGrantedAuthoritiesConverter);
}

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