API 33及以下Health Connect首次调用触发限流RemoteException问题

问题现象 #

在DataSapien SDK中使用Health Connect时，API 34版本下读取流程正常，但在API 33及以下版本中，首次调用就立即出现以下错误：

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

环境配置 #

• androidx.health.connect:connect-client:1.1.0
• compileSdk 36
• minSdk 26
• Kotlin 2.1.0 / 2.2.21

实现细节 #

客户端创建代码 #

fun getHealthConnectClient(): HealthConnectClient? {
    val ctx = context ?: return null
    when (HealthConnectClient.getSdkStatus(ctx)) {
        HealthConnectClient.SDK_UNAVAILABLE -> return null
        HealthConnectClient.SDK_UNAVAILABLE_PROVIDER_UPDATE_REQUIRED -> return null // opens Play Store
    }
    return HealthConnectClient.getOrCreate(ctx)
}

权限检查/请求逻辑 #

val client = HealthConnectClient.getOrCreate(activity)
val granted = client.permissionController.getGrantedPermissions()
if (!granted.containsAll(requiredPermissions)) {
    permissionLauncher.launch(requiredPermissions)
}

每个收集器在调用readRecords()前也会再次调用getGrantedPermissions()。

分页读取实现（30天范围） #

do {
    val response = client.readRecords(
        ReadRecordsRequest(
            recordType = StepsRecord::class,
            timeRangeFilter = TimeRangeFilter.between(start, end), // ~30 days
            pageSize = 1000,
            pageToken = pageToken
        )
    )
    pageToken = response.pageToken
} while (pageToken != null)

咨询问题 #

1. 为何在API 33及以下版本中，首次调用就会触发限流错误？
2. Health Connect作为独立应用运行时的配额是否比Android 14系统服务更严格？
3. 在共享SDK中，合理的Health Connect调用序列化/限流方式是什么？

1. API 33及以下版本首次调用触发限流的原因 #

API 33及以下版本中，Health Connect是以独立Google Play服务应用形式运行，而非Android 14（API 34）及以上的系统级服务，两者配额计算逻辑存在差异：

• 独立版Health Connect早期版本未区分辅助请求（如权限检查）和核心数据请求，所有IPC请求都会占用同一配额池，且总配额阈值更低。
• 当前实现中每个收集器调用readRecords()前都重复执行getGrantedPermissions()，高频的权限查询会快速消耗配额，多收集器并行执行时，首次启动就会触发限流。

2. 独立应用vs系统服务的配额差异 #

是的，独立版Health Connect的配额限制更严格：

• Android 14及以上的系统级Health Connect服务，会区分辅助请求和核心数据请求，仅核心请求占用主要配额，且整体阈值更高。
• 独立版Health Connect早期版本未做这类区分，所有对其服务的调用都计入同一配额池，更容易触发限流。

3. 共享SDK中合理的调用序列化/限流方案 #

针对共享SDK场景，推荐以下优化方案：

• 全局请求序列化：在SDK内部实现单线程任务队列，所有Health Connect API调用（包括权限检查、数据读写）都通过该队列串行执行，避免并行请求挤占配额。
• 缓存权限检查结果：将getGrantedPermissions()的结果缓存5-10分钟，无需每次调用核心API前重复查询，减少无效请求消耗。
• 自定义令牌桶限流：针对不同API设置请求频率限制：
  • 权限查询：限制为每5分钟最多1次
  • 数据读取：限制为每秒最多2次，分页请求自动延迟100ms后发起下一页
• 批量请求合并：读取多种健康数据时，使用readRecords()的多类型请求重载，替代多次单类型请求，减少IPC交互次数。

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