Keycloak v25未启用自定义TokenExchangeProvider问题求助

问题现状 #

• 执行kc.sh build及Keycloak启动时，日志均显示已识别到自定义提供者：

  WARN [org.key.services] (build-3) KC-SERVICES0047: custom-token-exchange-provider (pxtokenexchange.CustomTokenExchangeProviderFactory) is implementing the internal SPI oauth2-token-exchange. This SPI is internal and may change without notice
  WARN [org.key.services] (build-42) KC-SERVICES0047: custom-token-exchange-provider (pxtokenexchange.CustomTokenExchangeProviderFactory) is implementing the internal SPI oauth2-token-exchange. This SPI is internal and may change without notice

• 已尝试在构建时添加参数：

  kc.bat build --spi-token-exchange-provider--enabled=true --spi-token-exchange-provider-default-enabled=false
  

• 但自定义TokenExchangeProvider仍未被调用

排查解决方向 #

1. 修正SPI配置参数格式 #

你的命令行参数存在格式错误，正确的参数需匹配SPI名称oauth2-token-exchange及自定义提供者ID，示例：

kc.bat build --spi-oauth2-token-exchange-custom-token-exchange-provider-enabled=true --spi-oauth2-token-exchange-default-provider=custom-token-exchange-provider

参数结构规则：--spi-[spi名称]-[提供者ID]-enabled=true，同时需指定默认提供者为自定义实现。

2. 验证ProviderFactory实现 #

• 确保CustomTokenExchangeProviderFactory的getId()方法返回值为custom-token-exchange-provider，与日志中显示的ID完全一致。
• 检查create()方法是否正确初始化CustomTokenExchangeProvider实例。
• 若实现了isSupported()方法，确认其返回true，保证当前环境下提供者可被加载。

3. 改用配置文件指定参数 #

可将配置写入keycloak.conf，避免命令行参数格式问题，示例：

spi.oauth2-token-exchange.custom-token-exchange-provider.enabled=true
spi.oauth2-token-exchange.default-provider=custom-token-exchange-provider

修改后重新执行构建与启动。

4. 开启调试日志排查细节 #

启用Token Exchange模块的调试日志，查看流程中是否有加载失败或跳过自定义提供者的信息：

kc.bat start-dev --log-level=org.keycloak.services.token.exchange=DEBUG

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