iOS如何修复HKSampleQuery报错Query already exists的问题

错误信息回顾 #

HKSampleQuery 8F9ED0 QoS=Default state=active>: Invalid query activation state upon completing connection
HKSampleQuery QoS=Default state=deactivated>: Error reactivating query: Error Domain=com.apple.healthkit Code=100 "Query 'AF837C4C-6559-404F-8D7C-7226C0CD9216' already exists" UserInfo={NSLocalizedDescription=Query 'AF837C4C-6559-404F-8D7C-7226C0CD9216' already exists}

根因分析 #

两个报错分别对应两类问题：

1. Invalid query activation state upon completing connection：多线程无限制并发提交上千条查询，超出HealthStore内部的调度承载上限，查询状态更新出现线程竞争，系统无法正常完成查询激活流程
2. 错误码100的重复查询报错：不同业务组件提交了参数完全一致的重叠请求，同一个查询标识被多次注册到HealthKit触发系统拦截

修复方案 #

• 全局做查询去重：以样本类型、时间范围、查询筛选条件三个维度生成哈希值作为查询唯一标识，维护执行中/已完成的查询缓存池，相同参数的请求直接复用已有结果，禁止重复提交
• 控制查询并发数：HealthStore本身有内部保护机制，不支持大量并发请求，通过信号量或者OperationQueue将并发数限制在3~5，所有查询统一提交到专用串行队列调度，避免多线程操作导致的查询状态冲突
• 调整时间拉取粒度：不需要按1天拆分3年的拉取请求，改为7天或30天的时间粒度拉取，总请求量可压缩到几十的量级，既降低调度开销，也大幅减少重叠请求的出现概率
• 统一查询生命周期管理：所有查询的提交、取消、回调处理逻辑都收敛到同一个专用队列执行，禁止不同业务组件在各自线程随意操作HealthKit查询，避免出现查询刚被销毁又被其他组件重新提交的状态竞争问题

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