Android OkHttp 框架超时设置详解

OkHttp 提供了四种不同的超时设置,每种针对网络请求的不同阶段:

1. callTimeout (调用超时)

  • 作用:控制整个调用从开始到结束的总时间,包括所有重定向和重试

  • 默认值:0 (不超时)

  • 场景:当你希望限制整个请求的完成时间,无论中间经过多少次重定向或重试

  • 设置方法

    OkHttpClient client = new OkHttpClient.Builder() .callTimeout(30, TimeUnit.SECONDS) .build(); //这里设置为0,则永不超时

注:在弱网情况下,博主遇到还没下载完就判断为超时,导致下载失败,这时候需要设置callTimeout时间,可以修复问题

2. connectTimeout (连接超时)

  • 作用:控制与目标服务器建立连接的时间

  • 默认值:10秒

  • 场景:当服务器响应慢或网络状况差时,防止长时间等待连接建立

  • 设置方法

    OkHttpClient client = new OkHttpClient.Builder() .connectTimeout(15, TimeUnit.SECONDS) .build();

3. readTimeout (读取超时)

  • 作用:控制从服务器读取数据的间隔时间(两次数据包之间的时间)

  • 默认值:10秒

  • 场景:防止服务器响应慢或传输大文件时连接被长时间占用

  • 设置方法

    OkHttpClient client = new OkHttpClient.Builder() .readTimeout(30, TimeUnit.SECONDS) .build();

4. writeTimeout (写入超时)

  • 作用:控制向服务器发送数据的间隔时间(两次数据包之间的时间)

  • 默认值:10秒

  • 场景:防止上传大文件时由于网络状况差导致长时间占用连接

  • 设置方法

    OkHttpClient client = new OkHttpClient.Builder() .writeTimeout(30, TimeUnit.SECONDS) .build();

超时设置建议

  1. 根据网络环境调整:移动网络下建议设置较长的超时时间

  2. 根据请求类型调整:上传/下载大文件时需要增加读写超时

  3. 优先级关系:callTimeout > connectTimeout + readTimeout + writeTimeout

  4. 特殊需求:对于关键请求可以设置较短的callTimeout,确保快速失败

示例配置

复制代码
OkHttpClient client = new OkHttpClient.Builder()
    .callTimeout(60, TimeUnit.SECONDS)    // 总超时60秒
    .connectTimeout(15, TimeUnit.SECONDS) // 连接超时15秒
    .readTimeout(30, TimeUnit.SECONDS)    // 读取超时30秒
    .writeTimeout(30, TimeUnit.SECONDS)   // 写入超时30秒
    .build();

这些超时设置可以帮助你更好地控制网络请求行为,避免因网络问题导致应用无响应。

相关推荐
Kotlin上海用户组1 小时前
Koin vs. Hilt——最流行的 Android DI 框架全方位对比
android·架构·kotlin
zzq19961 小时前
Android framework 开发者模式下,如何修改动画过度模式
android
木叶丸2 小时前
Flutter 生命周期完全指南
android·flutter·ios
阿幸软件杂货间2 小时前
阿幸课堂随机点名
android·开发语言·javascript
没有了遇见2 小时前
Android 渐变色整理之功能实现<二>文字,背景,边框,进度条等
android
没有了遇见3 小时前
Android RecycleView 条目进入和滑出屏幕的渐变阴影效果
android
站在巨人肩膀上的码农3 小时前
去掉长按遥控器power键后提示关机、飞行模式的弹窗
android·安卓·rk·关机弹窗·power键·长按·飞行模式弹窗
呼啦啦--隔壁老王4 小时前
屏幕旋转流程
android
人生何处不修行4 小时前
实战:Android 15 (API 35) 适配 & 构建踩坑全记录
android
用户2018792831674 小时前
gralde的《依赖契约法典》
android