如何通过JAX-RS获取HTTP连接建立耗时（区别于响应读取耗时）

JAX-RS规范本身没有直接提供获取连接建立耗时的API，但可以通过拦截底层HTTP客户端的连接生命周期节点来实现统计，核心思路是在连接发起前和连接建立完成后分别记录时间戳，计算差值。以下是主流JAX-RS实现的具体方案：

1. 通用方案：基于Apache HttpClient拦截器（适用于Jersey/RESTEasy） #

大多数JAX-RS实现（如Jersey、RESTEasy）默认依赖Apache HttpClient作为底层HTTP客户端，我们可以给HttpClient添加自定义拦截器来捕获连接建立的时间点：

步骤1：编写连接计时拦截器 #

这个拦截器会在请求发起前记录开始时间，在连接建立并收到响应时计算耗时：

public class ConnectionTimingInterceptor implements HttpRequestInterceptor, HttpResponseInterceptor {
    // 用ThreadLocal存储每个请求的时间戳，避免多线程干扰
    private final ThreadLocal<Long> connectionStartNanos = new ThreadLocal<>();

    @Override
    public void process(HttpRequest request, HttpContext context) throws IOException {
        // 仅在首次发起请求时记录时间（排除重定向等场景）
        if (!(request instanceof HttpRequestWrapper)) {
            connectionStartNanos.set(System.nanoTime());
        }
    }

    @Override
    public void process(HttpResponse response, HttpContext context) throws IOException {
        Long start = connectionStartNanos.get();
        if (start != null) {
            long connectTimeMs = TimeUnit.NANOSECONDS.toMillis(System.nanoTime() - start);
            // 这里可以将耗时存入日志、请求上下文，或者直接输出
            System.out.printf("连接建立耗时: %d ms%n", connectTimeMs);
            
            // 清理ThreadLocal，避免内存泄漏
            connectionStartNanos.remove();
        }
    }
}

步骤2：关联拦截器到JAX-RS客户端 #

对于Jersey：

// 构建带拦截器的HttpClient
HttpClient httpClient = HttpClientBuilder.create()
        .addInterceptorFirst(new ConnectionTimingInterceptor())
        .build();

// 构建Jersey Client并关联自定义HttpClient
Client jerseyClient = ClientBuilder.newBuilder()
        .register(ApacheConnectorProvider.class)
        .property(ApacheClientProperties.HTTP_CLIENT, httpClient)
        .build();

对于RESTEasy：

HttpClient httpClient = HttpClientBuilder.create()
        .addInterceptorFirst(new ConnectionTimingInterceptor())
        .build();

ResteasyClient resteasyClient = new ResteasyClientBuilder()
        .httpEngine(new ApacheHttpClient4Engine(httpClient))
        .build();

2. 区分连接新建与复用 #

如果使用了连接池，大部分请求会复用已有的连接，此时连接建立耗时趋近于0。可以在拦截器中判断连接是否被复用：

@Override
public void process(HttpResponse response, HttpContext context) throws IOException {
    Long start = connectionStartNanos.get();
    if (start != null) {
        // 获取当前连接实例
        ManagedHttpClientConnection conn = (ManagedHttpClientConnection) 
                context.getAttribute(HttpCoreContext.HTTP_CONNECTION);
        boolean isReused = conn.isOpen() && !conn.isStale();
        
        if (isReused) {
            System.out.println("使用复用连接，无新建连接耗时");
        } else {
            long connectTimeMs = TimeUnit.NANOSECONDS.toMillis(System.nanoTime() - start);
            System.out.printf("新建连接耗时: %d ms%n", connectTimeMs);
        }
        connectionStartNanos.remove();
    }
}

注意事项 #

• 线程安全：必须用ThreadLocal存储时间戳，因为同一个拦截器实例会被多个请求线程共享。
• 生命周期边界：拦截器的process方法触发时机要准确，避免把重定向、重试等场景的时间算入连接耗时。
• 底层客户端差异：如果你的JAX-RS实现使用了其他底层客户端（如Jetty Client），需要对应调整拦截器的实现方式，但核心思路都是捕获连接建立的前后时间点。

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