迁移至okhttp3时调用OkHttpClient.setWriteTimeout提示未定义如何解决

OkHttp3 对客户端实例做了不可变设计，旧版直接在OkHttpClient实例上调用setXxx配置参数、直接访问公开属性的写法完全不兼容，触发未定义错误的核心原因是：

• writeTimeout相关的配置方法只存在于OkHttpClient.Builder构造器类上，不属于OkHttpClient实例的公开可调用方法/可直接访问的属性
• OkHttpClient实例上仅提供writeTimeout()的getter方法用于读取已配置的超时值，没有对应的setter，也没有公开可直接修改的writeTimeout字段

不要直接实例化OkHttpClient后修改参数，所有超时配置统一走Builder构建流程：

// 基础配置示例
OkHttpClient client = new OkHttpClient.Builder()
        .writeTimeout(10, TimeUnit.SECONDS) // 写超时配置，第一个参数为时间数值，第二个参数为时间单位
        .connectTimeout(10, TimeUnit.SECONDS)
        .readTimeout(10, TimeUnit.SECONDS)
        .build();

如果是基于已有的OkHttpClient实例做定制化修改，要调用实例自带的newBuilder()方法复制原有配置后再调整，不要尝试直接修改原实例的属性：

// 基于已有客户端修改配置的写法
OkHttpClient newClient = oldClient.newBuilder()
        .writeTimeout(15, TimeUnit.SECONDS) // 覆盖原有的写超时配置
        .build();

• 所有OkHttp3的配置项（包括连接超时、读超时、写超时、拦截器、证书校验规则等）全部在Builder层配置，OkHttpClient实例本身对外仅暴露getter，没有任何setter方法
• 不要尝试通过反射直接修改OkHttpClient实例的内部timeout字段，不同小版本的内部字段名、类型可能有变动，会引发版本兼容问题
• 配置完成调用build()生成的OkHttpClient实例是全局可复用的，不需要每次发起请求都新建实例

内容的提问来源于stack exchange，提问作者Ricky V.