使用Health Connect SDK读取距离记录触发速率限制异常的原因

问题背景 #

使用Health Connect SDK读取距离记录的代码如下：

suspend fun readDistanceInputs(start: Instant, end: Instant): List<DistanceRecord> {
    var pageToken: String? = null
    val records = mutableListOf<DistanceRecord>()

    do {
        val request = ReadRecordsRequest(
            recordType = DistanceRecord::class,
            timeRangeFilter = TimeRangeFilter.between(start, end),
            pageToken = pageToken
        )
        val response = healthConnectClient.readRecords(request)
        pageToken = response.pageToken
        records.addAll(response.records)
    } while(pageToken != null)

    return records
}

该代码在多数用户设备上正常运行，但部分用户首次使用应用时会触发以下异常：

RemoteException: Request rejected. Rate limited request quota has been exceeded. Please wait until quota has replenished before making further requests.

异常原因分析 #

• 密集分页请求超出频率配额：Health Connect API为了保护系统资源，设置了单位时间内的请求次数上限。如果用户的Health Connect中存储了大量历史距离记录（比如长期使用运动应用同步数据），你的代码会无间隔地连续发起多页查询，短时间内的调用次数直接突破配额，触发限流。
• 首次授权会话的临时严格限制：对于刚完成权限授权的新应用会话，Health Connect可能会施加更严格的临时请求阈值，防止恶意应用滥用权限。你的代码在授权完成后立即执行全量分页查询，刚好触发了这个限制。
• 缺少请求间隔控制：当前代码的分页循环没有添加任何延迟逻辑，拿到上一页的pageToken后立刻发起下一次请求，这种无间隙的密集调用很容易触发限流机制，在数据量大的用户场景下问题尤为明显。

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