Keycloak 26.2.x中无法启用自定义TokenExchangeProvider的问题求助

我刚仔细看了你的问题描述和代码细节，结合Keycloak 26.x版本的Token Exchange SPI改动，你遇到的问题主要来自几个配置和逻辑上的疏漏，下面给你拆解原因和对应的解决办法：

核心问题分析 #

1. Provider ID与内置组件冲突：你把自定义工厂的ID设为standard或default，这正好是Keycloak内置的StandardTokenExchangeProvider（ID为standard）和V1TokenExchangeProvider（ID为default）的标识。Keycloak加载SPI时，内置组件的优先级更高（核心包先被加载），导致你的自定义工厂根本没被注册生效。
2. supports方法逻辑错误：你的自定义Provider的supports方法直接返回false，即使工厂被成功注册，Keycloak也会判定这个Provider不支持当前请求，转而使用其他符合条件的内置Provider。
3. Order优先级设置反了：Keycloak中SPI的order值越小，优先级越高。StandardTokenExchangeProvider的order是10，你设为20意味着它的优先级比官方组件更低，所以官方Provider会被优先选中处理请求。

分步解决方案 #

1. 给自定义Provider设置唯一ID

修改工厂类的PROVIDER_ID为自己的专属标识，避免和内置Provider冲突：

private static final String PROVIDER_ID = "my-custom-token-exchange";

2. 修正supports方法的判断逻辑

supports方法是Keycloak选择Provider的核心依据，你需要根据业务场景返回true，比如只处理指定客户端的token交换请求：

@Override
public boolean supports(TokenExchangeContext tokenExchangeContext) {
    Client client = tokenExchangeContext.getClient();
    // 仅对目标客户端启用自定义逻辑
    if (KEYCLOAK_EXCHANGE_CLIENT_ID.equals(client.getClientId())) {
        return true;
    }
    // 其他场景交给父类的默认逻辑处理（可选）
    return super.supports(tokenExchangeContext);
}

3. 调整Order优先级数值

把order设为比内置Provider更小的数值，确保你的Provider优先级更高：

@Override
public int order() {
    return 5; // 比Standard的10小，优先级更高
}

4. 禁用内置Provider（可选，完全替换官方逻辑）

如果你希望彻底禁用官方的TokenExchangeProvider，可以通过启动参数关闭它们：

• 禁用StandardTokenExchangeProvider：

  ./kc.sh start --features=token-exchange-standard-v2 --spi-token-exchange-standard-enabled=false
  

• 禁用V1TokenExchangeProvider：

  ./kc.sh start --features=token-exchange --spi-token-exchange-default-enabled=false
  

5. 确保Feature开关与继承类匹配

• 如果你继承StandardTokenExchangeProvider，启动时必须开启token-exchange-standard-v2特性；
• 如果继承V1TokenExchangeProvider，则开启token-exchange特性，这部分你已经做了，但要确保和继承的类对应正确。

验证步骤 #

1. 重新打包自定义Provider，部署到Keycloak的providers目录；
2. 删除Keycloakdata目录下的缓存文件，避免旧配置残留；
3. 启动Keycloak并带上对应的特性和SPI禁用参数；
4. 发起token交换请求，检查是否进入自定义的exchange方法逻辑。

内容来源于stack exchange