retryOnConnectionFailure的作用
在OKHTTP中,retryOnConnectionFailure 是一个配置选项,它用于控制当网络连接失败时是否应该重试请求。这个选项通常在 OkHttpClient 的配置中设置,用于决定在网络连接失败的情况下,是否应该自动重试请求。
retryOnConnectionFailure
控制的是 连接失败 时是否自动重试请求。具体来说,如果设置为 true
,当请求连接失败时,OkHttp 会尝试重新建立连接并重试该请求;如果设置为 false
,则在连接失败时不会重试请求,而是直接返回失败。
默认值:
默认情况下,retryOnConnectionFailure
的值为 true
,这意味着如果请求的连接发生故障,OkHttp 会自动进行重试,直到请求成功或遇到最大重试次数(通常是无穷次,具体依赖于操作系统和网络环境)。
配置方式:
可以在创建 OkHttpClient
时,通过 OkHttpClient.Builder
配置 retryOnConnectionFailure
。比如:
val client = OkHttpClient.Builder()
.retryOnConnectionFailure(true) // 设置为 true 表示启用重试
.build()
如果你希望禁用自动重试,可以将其设置为 false
:
val client = OkHttpClient.Builder()
.retryOnConnectionFailure(false) // 设置为 false 表示禁用重试
.build()
适用场景:
/**
- Configure this client to retry or not when a connectivity problem is encountered. By default,this client silently recovers from the following problems:
- Unreachable IP addresses. If the URL's host has multiple IP addresses, failure to reach any individual IP address doesn't fail the overall request. This canincrease availability of multi-homed services.
- Stale pooled connections. The [ConnectionPool] reuses sockets to decrease request latency, but these connections will occasionally time out.
- Unreachable proxy servers. A [ProxySelector] can be used to attempt multiple proxy servers in sequence, eventually falling back to a direct connection.
- Set this to false to avoid retrying requests when doing so is destructive. In this case the calling application should do its own recovery of connectivity failures.
*/
通过上面的源码注释,可以看到retryOnConnectionFailure主要适用下面的三个场景,
- 自动重试连接:
例如,如果请求的服务器出现短暂的网络问题或连接问题(如服务器不可达、TCP 连接超时等),启用重试可以增加请求成功的机会,避免因临时网络问题导致请求失败。 - 防止短暂的网络波动导致请求失败:
在某些情况下,网络环境可能出现短暂的波动或丢包,如果不进行重试,请求可能会立即失败,影响用户体验。启用重试可以提高网络请求的成功率。 - 避免服务器压力过大:
如果某个请求失败并立即重试,可能会导致服务器在高负载下变得更加拥堵。对于某些高并发应用场景,避免重试可能是一个合理的选择。