创建多个 OkHttpClient 实例 场景

在 Android 开发中使用 OkHttp 时，创建多个 HttpClient 实例通常是为了满足不同的网络请求需求。以下是需要创建多个 HttpClient 的常见场景：

1. 不同的超时设置

• 短超时请求：普通API请求（5-10秒）

• 长超时请求：文件上传/下载（几分钟）

// 快速API请求Client
val fastClient = OkHttpClient.Builder()
    .connectTimeout(10, TimeUnit.SECONDS)
    .readTimeout(10, TimeUnit.SECONDS)
    .build()

// 文件下载Client
val downloadClient = OkHttpClient.Builder()
    .connectTimeout(60, TimeUnit.SECONDS)
    .readTimeout(300, TimeUnit.SECONDS)
    .build()

2. 不同的认证需求

• 不同API端点需要不同的认证方式

• 部分接口需要Token，部分需要Basic Auth

// 主API Client（带Token）
val apiClient = OkHttpClient.Builder()
    .addInterceptor(TokenInterceptor())
    .build()

// 第三方服务Client（带API Key）
val thirdPartyClient = OkHttpClient.Builder()
    .addInterceptor(ApiKeyInterceptor())
    .build()

3. 不同的拦截器需求

• 日志记录需求不同（部分接口需要详细日志）

• 数据加密/解密需求不同

// 带详细日志的Client
val debugClient = OkHttpClient.Builder()
    .addInterceptor(HttpLoggingInterceptor().apply {
        level = HttpLoggingInterceptor.Level.BODY
    })
    .build()

// 生产环境Client（无body日志）
val productionClient = OkHttpClient.Builder()
    .addInterceptor(HttpLoggingInterceptor().apply {
        level = HttpLoggingInterceptor.Level.BASIC
    })
    .build()

4. 不同的缓存策略

• 频繁更新的数据（禁用缓存）

• 静态资源（长期缓存）

// 无缓存Client
val noCacheClient = OkHttpClient.Builder()
    .cache(null)
    .build()

// 大缓存Client（用于静态资源）
val cacheClient = OkHttpClient.Builder()
    .cache(Cache(cacheDir, 50L * 1024 * 1024)) // 50MB缓存
    .build()

5. 不同的网络环境处理

• Wi-Fi和移动数据不同策略

• 弱网环境特殊处理

// 普通网络Client
val normalClient = OkHttpClient.Builder()
    .build()

// 弱网优化Client
val weakNetworkClient = OkHttpClient.Builder()
    .addInterceptor(WeakNetworkInterceptor())
    .build()

6. 不同的代理配置

• 部分请求需要走代理

• 测试环境需要特殊代理

// 直连Client
val directClient = OkHttpClient.Builder()
    .proxy(Proxy.NO_PROXY)
    .build()

// 代理Client
val proxyClient = OkHttpClient.Builder()
    .proxy(Proxy(Proxy.Type.HTTP, InetSocketAddress("proxy.example.com", 8080)))
    .build()

最佳实践建议

1. 不要过度创建：每个OkHttpClient都有自己的连接池和线程池，创建过多会浪费资源

2. 优先使用拦截器：如果只是请求头等小差异，优先考虑使用拦截器而不是创建新Client

3. 考虑使用单例模式：管理多个Client实例，避免重复创建

4. 评估实际需求：只有当配置差异确实需要独立Client时才创建

通常，一个中等复杂度的App可能需要2-3个不同的OkHttpClient实例（如API Client、下载Client、特殊认证Client等）。