1. Retrofit与OkHttp核心概念：拦截器链、动态代理与网络请求流程

1.1 原理：OkHttp 拦截器链与 Retrofit 动态代理

Retrofit 本质上是 OkHttp 的上层封装，通过 Java 动态代理将接口声明转化为 OkHttp 请求。OkHttp 则通过拦截器链（Interceptor Chain）实现请求/响应的拦截、修改、重试、日志等横切关注点。理解这两部分的协作是埋点拦截技术的基础。

1.2 实现流程：从接口定义到网络响应

1. 定义 Java/Kotlin 接口，使用 @GET、@POST 等注解声明 API。
2. 创建 Retrofit 实例，配置 baseUrl、ConverterFactory、CallAdapterFactory 以及自定义的 OkHttpClient。
3. Retrofit 通过 动态代理 在运行时生成接口的实现类，每个方法调用返回一个 Call<T> 对象。
4. 执行 Call.execute() 或 enqueue() 时，OkHttpClient 按照构建的 拦截器链 处理请求：依次经过应用拦截器 → 重定向拦截器 → 网络拦截器 → 实际网络调用。
5. 响应沿拦截器链逆向返回，最终由 Converter 将 ResponseBody 转换为 Java 对象。

1.3 代码示例：基础配置与拦截器接入

1.3.1 定义接口

public interface ApiService {
    @GET("users/{id}")
    Call<User> getUser(@Path("id") int userId);

    @POST("login")
    Call<> login(@Body LoginRequest request);
}

1.3.2 创建 Retrofit 实例（含自定义拦截器）

OkHttpClient client = new OkHttpClient.Builder()
        .addInterceptor(new TracingInterceptor())   // 应用拦截器，用于埋点
        .addNetworkInterceptor(new LoggingInterceptor()) // 网络拦截器
        .connectTimeout(15, TimeUnit.SECONDS)
        .readTimeout(15, TimeUnit.SECONDS)
        .build();

Retrofit retrofit = new Retrofit.Builder()
        .baseUrl("https://api.example.com/")
        .client(client)
        .addConverterFactory(GsonConverterFactory.create())
        .build();

ApiService service = retrofit.create(ApiService.class);

1.3.3 简单的埋点拦截器示例

public class TracingInterceptor implements Interceptor {
    @Override
    public Response intercept(Chain chain) throws IOException {
        Request request = chain.request();
        long start = System.currentTimeMillis();

        // 埋点：记录请求 URL、方法、头信息
        Log.d("Trace", "Request: " + request.method() + " " + request.url());

        Response response = chain.proceed(request);
        long elapsed = System.currentTimeMillis() - start;

        // 埋点：记录响应码、耗时
        Log.d("Trace", "Response: " + response.code() + " in " + elapsed + "ms");
        return response;
    }
}

1.4 调试与配置

• 日志拦截器：使用 OkHttp 官方 HttpLoggingInterceptor 观察完整请求/响应细节，级别设为 BODY 可查看 payload。
• 断点调试：在自定义拦截器的 intercept() 方法处设置断点，观察 Request/Response 对象的结构。
• 配置优化：为 OkHttpClient 统一设置超时、重试、缓存策略，避免埋点干扰业务超时。

1.5 常见错误与避坑

1.6 性能与稳定性优化

• 连接池复用：OkHttp 默认维护 5 个空闲连接，不要频繁创建新 OkHttpClient，应作为单例管理。
• 超时设置：埋点拦截器不应显著增加请求时长，计算耗时尽量使用 System.nanoTime() 避免受线程调度影响。
• 异步埋点：若埋点数据需要写入磁盘或发送至后端，应使用异步队列，避免堵塞拦截器线程。
• 最小侵入：埋点拦截器应只读不做修改，如需修改请求头或 body 需使用 request.newBuilder() 并保证幂等性。