如何将自定义Keycloak Provider从Resteasy-client迁移至Keycloak 25

一、依赖配置调整 #

Keycloak 25基于Quarkus构建，默认使用Resteasy Reactive而非传统Resteasy，必须移除传统resteasy-client依赖，替换为Quarkus提供的Reactive客户端依赖：

<!-- 移除旧的传统Resteasy Client依赖 -->
<!-- <dependency>
    <groupId>org.jboss.resteasy</groupId>
    <artifactId>resteasy-client</artifactId>
    <version>6.2.9.Final</version>
</dependency> -->

<!-- 添加Quarkus Resteasy Reactive客户端依赖 -->
<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-resteasy-reactive-jackson</artifactId>
    <!-- 版本无需手动指定，Keycloak BOM会自动管理兼容版本 -->
</dependency>
<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-rest-client-reactive</artifactId>
</dependency>

注意：依赖版本无需手动指定，Keycloak的BOM会自动匹配兼容的Quarkus及Resteasy Reactive版本，避免版本冲突。

二、代码修改方案 #

方案1：使用标准JAX-RS Client API（推荐，无强依赖特定实现） #

放弃传统Resteasy特定类，改用JAX-RS标准API，避免与Keycloak内置实现冲突：

import jakarta.ws.rs.client.Client;
import jakarta.ws.rs.client.ClientBuilder;
import jakarta.ws.rs.client.WebTarget;
import jakarta.ws.rs.core.UriBuilder;

// ...

UriBuilder url = UriBuilder.fromPath(baseURL);
Client client = ClientBuilder.newClient();
WebTarget target = client.target(url);
this.proxy = target.proxy(MyClientInterface.class);

方案2：使用Quarkus RestClient注解方式（适配Quarkus生态） #

如果自定义Provider支持CDI注入，推荐使用Quarkus的@RegisterRestClient注解简化客户端创建：

1. 定义带注解的客户端接口：

import jakarta.ws.rs.GET;
import jakarta.ws.rs.Path;
import org.eclipse.microprofile.rest.client.inject.RegisterRestClient;

@RegisterRestClient(baseUri = "${your.target.service.url}")
public interface MyClientInterface {
    @GET
    @Path("/api/your-endpoint")
    String fetchData();
}

2. 在自定义Provider中注入客户端：

import org.eclipse.microprofile.rest.client.inject.RestClient;
import jakarta.inject.Inject;

public class CustomProvider {
    @Inject
    @RestClient
    MyClientInterface proxy;

    // 直接使用proxy调用目标服务接口
}

3. 在配置文件（如keycloak.properties）中添加基础URL：

your.target.service.url=https://your-target-service-domain.com

三、异常原因说明 #

添加传统resteasy-client依赖后出现类转换异常，核心原因是Keycloak 25内置的Resteasy Reactive实现与传统Resteasy类结构不兼容：

• 传统Resteasy使用org.jboss.resteasy.core.interception.jaxrs.PostMatchContainerRequestContext类
• Keycloak 25基于Quarkus，使用org.jboss.resteasy.reactive.server.jaxrs.ContainerRequestContextImpl类
  两者属于不同类加载上下文，导致类型强制转换失败。

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