现有运行的Micronaut服务如何正确创建HttpClient调用第三方接口

你遇到的端口占用报错和HttpClient本身无关，是代码中错误调用了ApplicationContext.run(EmbeddedServer.class)，这行代码会启动一个全新的Micronaut服务实例，而你的原有服务已经占用了8080端口，新实例启动自然会抛出端口冲突异常。

Micronaut的HttpClient完全可以在正式业务环境中使用，并非仅支持测试场景，它本身就是Micronaut官方提供的原生HTTP调用组件，性能、稳定性均满足生产要求。

方案1：声明式HTTP客户端（官方推荐，适合固定第三方接口调用场景） #

这是Micronaut最推荐的业务集成方式，无需手动管理客户端生命周期，代码简洁易维护。

1. 定义第三方调用客户端接口

import io.micronaut.http.annotation.Get;
import io.micronaut.http.client.annotation.Client;

// 注解值可直接写固定服务地址，也可引用配置项，比如配置文件中配置thirdparty.service.url=https://xxx.com
@Client("${thirdparty.service.url}")
public interface ThirdPartyApiClient {
    // 对应第三方服务的接口路径、请求方法、请求参数
    @Get("/target/api/path")
    String getThirdPartyResponse();
}

2. 业务代码中直接注入使用

import jakarta.inject.Inject;
import jakarta.inject.Singleton;

@Singleton
public class YourBusinessService {
    @Inject
    ThirdPartyApiClient thirdPartyApiClient;

    public void executeBizLogic() {
        // 直接调用接口方法即可发起HTTP请求
        String result = thirdPartyApiClient.getThirdPartyResponse();
        // 后续处理业务逻辑
    }
}

方案2：编程式HttpClient（适合动态URL调用场景） #

如果你需要根据业务动态拼接请求URL，可直接注入原生HttpClient实例使用，无需手动创建ApplicationContext和EmbeddedServer。

import io.micronaut.http.HttpRequest;
import io.micronaut.http.HttpResponse;
import io.micronaut.http.client.HttpClient;
import io.micronaut.http.client.annotation.Client;
import jakarta.inject.Inject;
import jakarta.inject.Singleton;

@Singleton
public class YourBusinessService {
    // 注入全局HttpClient实例，若需要固定baseUrl可改为@Client("https://固定前缀地址")
    @Inject
    @Client
    HttpClient httpClient;

    public String callDynamicUrl(String urlHost) {
        HttpRequest<String> req = HttpRequest.GET(urlHost);
        HttpResponse<String> response = httpClient.toBlocking().exchange(req, String.class);
        return response.body();
    }
}

特殊场景需要手动创建独立的HttpClient实例时，可直接使用HttpClient.create()静态方法，无需关联任何EmbeddedServer：

// 手动创建独立HttpClient，参数为目标服务baseUrl，也可传空后续用完整URL调用
HttpClient client = HttpClient.create(new URL("https://thirdparty.com"));

可在application.yml中添加HttpClient全局配置，适配业务性能要求：

micronaut:
  http:
    client:
      connect-timeout: 5s # 连接超时时间
      read-timeout: 10s # 读取超时时间
      max-connections: 200 # 连接池最大连接数

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