第2章 OkHttp拦截器体系与执行顺序

在深入Retrofit埋点之前，必须掌握其底层网络组件OkHttp的拦截器体系。拦截器是OkHttp请求/响应的核心扩展点，理解每种拦截器的定位、执行顺序及适用场景，是实现精准、高效网络埋点的前提。

2.1 拦截器体系结构

OkHttp共内置四类拦截器，按其注册位置与职责分为两层：Application拦截器在链路最外层，Network拦截器在最内层；中间由重试重定向拦截器和Bridge拦截器串联。整体执行流程如下SVG所示。

2.2 四种拦截器职责对比

2.3 拦截器注册与执行顺序验证

通过以下代码创建OkHttpClient并注册两类拦截器，观察日志输出顺序。

// Application拦截器
Interceptor appInterceptor = new Interceptor() {
    @Override
    public Response intercept(Chain chain) throws IOException {
        System.out.println("[App] 请求前: " + chain.request().url());
        Response response = chain.proceed(chain.request());
        System.out.println("[App] 响应后: " + response.code());
        return response;
    }
};

// Network拦截器
Interceptor netInterceptor = new Interceptor() {
    @Override
    public Response intercept(Chain chain) throws IOException {
        System.out.println("[Net] 请求前: " + chain.request().url());
        Response response = chain.proceed(chain.request());
        System.out.println("[Net] 响应后: " + response.code());
        return response;
    }
};

OkHttpClient client = new OkHttpClient.Builder()
        .addInterceptor(appInterceptor)            // 最外层
        .addNetworkInterceptor(netInterceptor)     // 最内层
        .build();

// 发起请求（可能触发重试）
client.newCall(new Request.Builder().url("http://httpbin.org/status/302").build()).execute();

2.4 埋点场景中的选择策略

• 业务埋点（用户行为统计）：使用Application拦截器，保证无论内部发生多少次重试，只记录一次业务事件。
• 网络性能监控（重试次数、首字节时间）：使用Network拦截器，准确获取每次真实网络请求的耗时与状态码。
• Cookie/Header管理：使用Bridge拦截器之前的Application拦截器进行全局注入，避免与Bridge逻辑冲突。

2.5 常见错误与避坑

2.6 性能与稳定性优化要点

• 避免在网络拦截器做线程阻塞操作：Network拦截器运行在OkHttp的IO线程池，阻塞会显著降低并发吞吐。
• 使用无锁数据结构记录埋点：如ConcurrentLinkedQueue或RingBuffer，防止高并发时锁竞争。
• 控制拦截器链长度：每个拦截器增加一次链调用开销，建议Application拦截器不超过3个，Network拦截器不超过2个。
• 利用链路追踪ID关联多次网络请求：在Application拦截器中生成唯一请求ID，传递到Network拦截器用于聚合重试数据。

2.7 小结