基于Quarkus与RESTEasy，如何在运行时编程定义Rest Client目标URL？

以下方案均可适配运行时无固定服务地址、需要动态传入目标URL的业务场景： #

方案1：编程式构建独立客户端实例 #

直接使用MicroProfile Rest Client提供的构建器API，运行时传入动态URL生成接口代理对象，不依赖配置文件的静态绑定。

• 不需要提前在配置文件中定义对应接口的mp-rest/url值
• 构建的实例独立于CDI容器管理链路，完全随代码运行时逻辑创建
• 代码示例：

// 导入构建器核心类
import org.eclipse.microprofile.rest.client.RestClientBuilder;
// ...
// 运行时获取动态目标URL，例如从请求上下文、上游回调参数、数据库记录中读取
String runtimeDynamicUrl = "https://callback-determined-at-runtime.example.com/rest";
// 基于动态URL构建客户端代理
CountriesService dynamicClient = RestClientBuilder.newBuilder()
        .baseUri(URI.create(runtimeDynamicUrl))
        .build(CountriesService.class);
// 直接调用接口方法发起请求
Set<Country> result = dynamicClient.getByName("france");

适用场景：服务地址完全不固定，每次业务调用都可能指向不同目标的场景。 #

方案2：动态覆盖CDI托管客户端的全局配置 #

如果要复用CDI容器中已经注册的客户端实例，可以通过运行时修改对应配置项的方式，动态替换全局绑定的目标URL。

• 保留原有接口上的@RegisterRestClient注解，以及常规的@Inject @RestClient注入逻辑
• 运行时通过ConfigProvider向全局配置源中写入动态URL值，对应的配置Key规则为：CountriesService全限定类名/mp-rest/url
• 已注入的客户端实例会在构建请求时自动读取最新的配置值，所有后续请求统一指向更新后的目标地址，不需要重启应用
  适用场景：应用启动后从外部源（配置中心、接口回调）一次性拉取服务地址，后续一段时间内全局请求固定指向该地址的场景。

方案3：单次请求级指定目标地址 #

如果不需要全局修改客户端配置，仅需要在单次调用中临时切换目标地址，可以通过接口方法参数传入完整请求URI，覆盖客户端预设的基础路径。

• 调整原有接口，增加带@jakarta.ws.rs.Uri注解的参数，该参数传入的完整URI优先级高于客户端预设的baseUri
• 接口修改示例：

@Path("/v1")
@RegisterRestClient
public interface CountriesService {
    @GET
    @Path("/name/{name}")
    Set<Country> getByName(@jakarta.ws.rs.Uri URI fullDynamicUri, @PathParam String name);
}

• 调用示例：

// 常规注入CDI托管的基础客户端实例
@Inject
@RestClient
CountriesService baseClient;
// 为单次请求传入完整的动态目标URI
URI singleRequestTarget = URI.create("https://runtime-temp-target.example.com/v1/name/japan");
// 发起请求，仅本次调用使用动态传入的地址，不影响其他请求的目标
Set<Country> result = baseClient.getByName(singleRequestTarget, "japan");

适用场景：同一个客户端接口需要按需临时调用不同目标地址，且不希望互相影响的场景。 #

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