自定义OkHttpClient超时设置无效，请求仍10秒后超时报错

1. 自定义OkHttpClient未被实际调用 #

先确认你创建的Retrofit实例确实被用来生成接口服务类。比如有没有其他地方偷偷创建了默认Retrofit实例，或者依赖注入框架（如Dagger、Hilt）里的配置覆盖了你的自定义客户端。举个例子，如果用Hilt，要确保绑定的是你配置的OkHttpClient，而不是默认实现。

2. 拦截器篡改了超时设置 #

检查你添加的所有拦截器，有些拦截器可能会在内部重新创建OkHttpClient并设置了10秒超时，直接覆盖了全局配置。比如这种错误写法：

Interceptor badInterceptor = chain -> {
    // 这里重新创建的客户端会覆盖全局超时
    OkHttpClient tempClient = new OkHttpClient.Builder()
        .readTimeout(10, TimeUnit.SECONDS)
        .build();
    return tempClient.newCall(chain.request()).execute();
};

逐个排查拦截器，确保它们不会替换客户端或修改超时参数。

3. 系统/环境层面的超时限制 #

• 部分Android设备或定制ROM会对后台请求强制设置短超时，试试把请求放到前台发起，看是否还会10秒超时。
• 如果应用用了代理或VPN，这些中间层可能自带10秒超时限制，关闭后重试测试。

4. 502错误的真实诱因 #

502是网关错误，虽然Postman正常，但要核对应用和Postman的请求是否完全一致：

• 请求头（比如User-Agent、Authorization）是否完全相同
• 请求参数、Body内容有没有差异
• 应用是否走了和Postman不同的网关/CDN，而这个网关本身有10秒超时规则

5. 版本兼容性bug #

旧版本的OkHttpClient或Retrofit可能存在配置不生效的问题，尝试升级到最新稳定版：

• OkHttpClient：更新com.squareup.okhttp3:okhttp到最新版
• Retrofit：更新com.squareup.retrofit2:retrofit到最新版

内容的提问来源于stack exchange，提问作者Renan Assis