2. Interceptor 接口与 Chain 接口核心方法：intercept()、request()、proceed()、response() 作用与调用时机

2.1 两个核心接口的设计意图

OkHttp 的拦截器（Interceptor）体系是整个网络层模块化的基石。Interceptor 接口定义了拦截器需要实现的拦截逻辑， Chain 接口则封装了整个请求链的串联机制。一次网络请求从创建到响应，会依次穿过多个拦截器， 每个拦截器通过 Chain 获得当前请求、将请求传递给下一个拦截器、并最终拿到响应。

2.2 核心方法详解

2.3 调用时机与流程

下图展示了三个拦截器组成的典型链，清晰呈现了各方法的调用顺序与数据流向。

2.4 实现代码示例

下面展示一个自定义日志拦截器的完整实现，它重写了 intercept() 并使用了所有核心方法：

public class LoggingInterceptor implements Interceptor {
    @Override
    public Response intercept(Chain chain) throws IOException {
        // 1. 获取当前请求
        Request request = chain.request();
        long startTime = System.nanoTime();
        System.out.println("发送请求: " + request.method() + " " + request.url());

        // 2. 将请求传递给下一个拦截器，并等待响应（此处会阻塞）
        Response response = chain.proceed(request);

        long elapsedTime = (System.nanoTime() - startTime) / 1_000_000;
        System.out.println("接收响应: " + response.code()
                + " (耗时 " + elapsedTime + " ms)");

        // 3. 返回响应（可以在此对响应进行包装、缓存等）
        return response;
    }
}

2.5 proceed() 的内部原理

调用 chain.proceed(request) 时，实际上触发了递归式的调用：

• OkHttp 的 RealInterceptorChain 内部保存了一个拦截器列表和当前索引。
• proceed() 会创建一个新的 RealInterceptorChain（索引 +1），并调用下一个拦截器的 intercept() 方法。
• 最后一个拦截器（如网络拦截器或连接拦截器）会真正执行 HTTP 调用（如 Socket 读写）并返回 Response。

2.6 常见错误与警告

2.7 性能与稳定性优化建议

2.8 调试技巧

在开发阶段，为每个拦截器添加唯一的 UUID 到 Request header 中，可以帮助追踪请求经过的路径：

Request request = chain.request().newBuilder()
        .header("X-Trace-Id", UUID.randomUUID().toString())
        .build();

然后通过日志或服务端日志即可验证拦截器是否按预期顺序执行。