Spring Boot授权服务器client_secret_basic认证报invalid_client错误

算力阿峰

2026-7-30

问题解答

你的理解完全正确：使用client_secret_basic认证方式时，确实需要将clientId:clientSecret（英文冒号拼接）进行Base64编码，然后放在Authorization请求头中，格式为Authorization: Basic <Base64编码字符串>。

出现invalid_client错误，大概率是以下几个细节没处理到位：

1. Base64编码的格式错误

必须用英文冒号拼接clientId和明文clientSecret，不能加多余空格，比如正确格式是my-client:my-plain-secret，而非my-client : my-plain-secret
编码后的字符串不能包含换行符，Postman粘贴时要确保没有多余换行

2. 客户端密码编码器配置不匹配

你用Bcrypt加密存储client_secret，要确保授权服务器配置了对应的PasswordEncoder：

检查配置类中是否声明了Bcrypt密码编码器Bean：

@Bean
public PasswordEncoder passwordEncoder() {
    return new BCryptPasswordEncoder();
}

确认RegisteredClient对象中的clientSecret是通过该编码器加密后的字符串，且配置中关联了这个编码器

3. 客户端认证方式配置不完整

检查你的授权服务器配置，确保客户端的clientAuthenticationMethods包含ClientAuthenticationMethod.CLIENT_SECRET_BASIC，比如：

@Bean
public RegisteredClientRepository registeredClientRepository(PasswordEncoder passwordEncoder) {
    RegisteredClient client = RegisteredClient.withId(UUID.randomUUID().toString())
            .clientId("test-client")
            .clientSecret(passwordEncoder.encode("test-secret"))
            .clientAuthenticationMethod(ClientAuthenticationMethod.CLIENT_SECRET_BASIC)
            .authorizationGrantType(AuthorizationGrantType.CLIENT_CREDENTIALS)
            .scope("read")
            .build();
    return new InMemoryRegisteredClientRepository(client);
}