Spring Boot整合KeyCloak重写ClientIdAndSecretCredentialsProvider不生效如何解决

问题原因 #

Keycloak 客户端适配器默认通过 Java SPI 机制加载 ClientCredentialsProvider 实现类，你只编写了自定义实现类，没有完成 SPI 注册和对应配置，所以适配器依旧会调用原生的默认实现。

解决步骤 #

步骤1：注册自定义实现到SPI #

在你的项目资源目录下创建 SPI 配置文件：

1. 新建路径 src/main/resources/META-INF/services
2. 在上述路径下新建名为 org.keycloak.adapters.authentication.ClientCredentialsProvider 的文件
3. 文件内容写入你自定义类的全限定名，示例：

com.yourpackage.CustomClientCredentialsProvider

需要替换成你自己项目里 CustomClientCredentialsProvider 对应的完整包路径。

步骤2：配置指定使用自定义凭证提供器 #

根据你的配置方式二选一即可：

方式A：application.yml/properties 配置

如果使用 Keycloak 官方 Spring Boot Starter 配置，在配置文件中添加以下配置：

# 因为你的自定义实现 PROVIDER_ID 复用了默认的 secret，直接指定 provider 为 secret 即可
keycloak.credentials.provider=secret

如果后续你把自定义实现的 PROVIDER_ID 改成了唯一值（比如 custom-secret 避免和默认实现冲突），这里填你自定义的 ID 即可。

方式B：手动构建 KeycloakDeployment 配置

如果你是手动初始化 KeycloakDeployment 对象，需要在凭证配置中指定 provider：

Map<String, Object> credentials = new HashMap<>();
credentials.put("provider", CustomClientCredentialsProvider.PROVIDER_ID);
// 补充其他凭证相关配置
deployment.setCredentials(credentials);

可选优化：避免ID冲突 #

你目前自定义实现的 PROVIDER_ID 和原生 ClientIdAndSecretCredentialsProvider 的 ID 完全一致，SPI 加载时会按注册顺序覆盖，为了避免意外冲突，建议修改为唯一值：

// 修改为自定义唯一ID
public static final String PROVIDER_ID = "custom-client-secret";

修改后对应配置里的 provider 值同步改为 custom-client-secret 即可。

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