Spring Boot OAuth2 JWT应用启动报错：Invalid JWK Set URL: null

我之前踩过这个坑，这个错误本质是因为你的OAuth2授权服务器配置不完整——框架默认会尝试加载JWK（JSON Web Key）相关配置，但你没有指定对应的URL，也没明确配置JWT的Token存储策略，所以才抛出了空指针异常。下面是具体的解决步骤和完整配置示例：

1. 补全AuthorizationServerConfig的完整配置 #

你当前的代码片段只初始化了JwtAccessTokenConverter，但缺少了关键的TokenStore配置和客户端信息配置。完整的配置应该包含这些内容：

@Configuration
@EnableAuthorizationServer
public class OAuth2Config extends AuthorizationServerConfigurerAdapter {

    private final AuthenticationManager authenticationManager;
    private final PasswordEncoder passwordEncoder;

    // 构造注入需要的Bean，这些Bean需要你在其他配置类中提前定义
    public OAuth2Config(AuthenticationManager authenticationManager, PasswordEncoder passwordEncoder) {
        this.authenticationManager = authenticationManager;
        this.passwordEncoder = passwordEncoder;
    }

    @Bean
    public JwtAccessTokenConverter jwtAccessTokenConverter() {
        JwtAccessTokenConverter converter = new CustomTokenEnhancer();
        // 从resources目录的JKS文件加载密钥对
        KeyPair keyPair = new KeyStoreKeyFactory(
                new ClassPathResource("jwt.jks"),
                "password".toCharArray() // 替换成你的密钥库密码
        ).getKeyPair("jwt"); // 替换成你的密钥别名
        converter.setKeyPair(keyPair);
        return converter;
    }

    @Bean
    public TokenStore tokenStore() {
        // 明确指定使用JWT Token存储，关联我们的转换器
        return new JwtTokenStore(jwtAccessTokenConverter());
    }

    @Override
    public void configure(AuthorizationServerEndpointsConfigurer endpoints) throws Exception {
        endpoints
                .authenticationManager(authenticationManager) // 配置认证管理器
                .tokenStore(tokenStore()) // 指定Token存储方式
                .accessTokenConverter(jwtAccessTokenConverter()); // 绑定JWT转换器
    }

    @Override
    public void configure(ClientDetailsServiceConfigurer clients) throws Exception {
        // 这里是示例的内存客户端配置，实际项目可以换成数据库存储
        clients.inMemory()
                .withClient("your-client-id")
                .secret(passwordEncoder.encode("your-client-secret"))
                .authorizedGrantTypes("password", "refresh_token")
                .scopes("read", "write")
                .accessTokenValiditySeconds(3600)
                .refreshTokenValiditySeconds(86400);
    }

    @Override
    public void configure(AuthorizationServerSecurityConfigurer security) throws Exception {
        security
                .tokenKeyAccess("permitAll()") // 允许公开获取JWT公钥
                .checkTokenAccess("isAuthenticated()"); // 校验Token需要认证
    }
}

2. 检查你的CustomTokenEnhancer实现 #

如果你的CustomTokenEnhancer是继承自JwtAccessTokenConverter，一定要确保没有破坏父类的签名逻辑。比如自定义Claims的时候，要记得调用父类的enhance方法：

public class CustomTokenEnhancer extends JwtAccessTokenConverter {
    @Override
    public OAuth2AccessToken enhance(OAuth2AccessToken accessToken, OAuth2Authentication authentication) {
        // 添加你需要的自定义Claims
        Map<String, Object> additionalInfo = new HashMap<>();
        additionalInfo.put("username", authentication.getName());
        additionalInfo.put("custom-data", "your-custom-value");
        
        ((DefaultOAuth2AccessToken) accessToken).setAdditionalInformation(additionalInfo);
        // 必须调用父类方法完成JWT的签名，否则会导致Token无效
        return super.enhance(accessToken, authentication);
    }
}

3. 验证JKS密钥库的正确性 #

最后再确认一下你的JKS文件：

• 确保jwt.jks确实放在src/main/resources目录下
• 用keytool命令验证密钥库密码和别名是否正确：

  keytool -list -keystore jwt.jks -alias jwt
  

  输入密码后如果能正常显示密钥信息，说明密钥库没问题。

为什么会出现这个错误？ #

简单来说，Spring Security OAuth2在没有明确配置TokenStore为JwtTokenStore时，会尝试使用默认的JWK相关组件，但你没有配置JWK Set的URL，所以就抛出了"Invalid JWK Set URL: null"的异常。通过明确指定JWT的Token存储策略，就能让框架走正确的JWT签名路径，避免这个问题。

内容的提问来源于stack exchange，提问作者Nafaz M N M