http-interface-clients

声明式 HTTP 接口客户端（Boot 3）

Spring Framework 6 支持 @HttpExchange 接口，但 Boot 3 不提供 Boot 4 的 @ImportHttpServices 分组自动注册功能。请显式构建客户端适配器。

@HttpExchange("/orders")
interface OrderApiClient {
    @GetExchange("/{id}")
    OrderDto get(@PathVariable UUID id);
}

@Configuration
class ClientConfig {
    @Bean
    OrderApiClient orderApiClient(RestClient.Builder builder,
                                  @Value("${clients.orders.base-url}") String baseUrl) {
        RestClient client = builder.baseUrl(baseUrl).build();
        HttpServiceProxyFactory factory =
            HttpServiceProxyFactory.builderFor(RestClientAdapter.create(client)).build();
        return factory.createClient(OrderApiClient.class);
    }
}

对于返回 Mono 或 Flux 的响应式接口，请使用 WebClientAdapter。在客户端适配器层配置基础 URL、 超时、身份验证和错误转换，而不要在控制器或领域服务中配置。优先为每个外部服务配置一个工厂／配置器。

注意事项

• Agent 使用 @ImportHttpServices——该 Boot 4 注册 API 在 Boot 3 中不可用。
• Agent 为接口添加 @Component 或实现——请将生成的代理注册为 Bean。
• Agent 对 Mono 或 Flux 使用 RestClient——响应式返回类型请使用 WebClientAdapter。
• Agent 在注解中硬编码远程主机——请将 URL 放在配置中。
• Agent 让传输错误泄漏到领域层——请在客户端适配器中转换这些错误。
• Agent 为每个请求创建一个新客户端——请配置并复用单例代理。