OkHttp 2.7.5升级至4.10.0遇阻，求实现文档与解决方案

核心版本差异与关键变更 #

1. 包名全局替换 #

OkHttp 3.x+ 将基础包名从 com.squareup.okhttp 统一改为 com.squareup.okhttp3，所有相关类（OkHttpClient、Request、Response、Interceptor 等）的导入路径都需要同步修改。

2. 客户端构建逻辑调整 #

OkHttp 4.x 对 OkHttpClient.Builder 的方法做了简化（移除前缀 set），同时兼容新旧两种超时时间配置方式：

// OkHttp 2.x 写法
OkHttpClient client = new OkHttpClient.Builder()
    .setConnectTimeout(10, TimeUnit.SECONDS)
    .setReadTimeout(10, TimeUnit.SECONDS)
    .build();

// OkHttp 4.x 兼容写法二选一
OkHttpClient client = new OkHttpClient.Builder()
    .connectTimeout(10, TimeUnit.SECONDS) // 保留旧时间单位方式
    .readTimeout(Duration.ofSeconds(10))  // 新增Duration方式
    .build();

3. 拦截器实现重构 #

拦截器接口的核心逻辑未变，但需替换包名，同时注意 Response.Builder 等辅助类的路径变更：

// OkHttp 2.x 拦截器
import com.squareup.okhttp.Interceptor;
import com.squareup.okhttp.Request;
import com.squareup.okhttp.Response;

public class CustomInterceptor implements Interceptor {
    @Override
    public Response intercept(Chain chain) throws IOException {
        Request request = chain.request().newBuilder()
            .addHeader("X-Custom-Header", "value")
            .build();
        return chain.proceed(request);
    }
}

// OkHttp 4.x 拦截器（仅替换包名即可）
import com.squareup.okhttp3.Interceptor;
import com.squareup.okhttp3.Request;
import com.squareup.okhttp3.Response;

public class CustomInterceptor implements Interceptor {
    @Override
    public Response intercept(Chain chain) throws IOException {
        Request request = chain.request().newBuilder()
            .addHeader("X-Custom-Header", "value")
            .build();
        return chain.proceed(request);
    }
}

Kotlin依赖兼容Java的说明 #

OkHttp 4.x 采用Kotlin重写，但完全兼容Java项目：

• Maven仓库中看到的Kotlin文件为源码包，实际引入的依赖包含编译后的字节码，Java代码可直接调用所有API，无需额外配置Kotlin环境
• 所有原Java风格的调用逻辑（如Builder模式、接口实现）均保持兼容，仅需关注包名和方法名的细微调整

常见错误快速修复 #

• 编译错误：找不到类/方法：全局替换包名 com.squareup.okhttp → com.squareup.okhttp3，检查Builder方法是否移除了set前缀
• 运行时错误：超时配置无效：将setConnectTimeout改为connectTimeout，或切换为Duration参数格式
• 拦截器不生效：确认拦截器通过client.addInterceptor()或addNetworkInterceptor()添加，且包名正确

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