iOS15系统中HealthKit的enableBackgroundDelivery按小时触发失效问题

核心原因 #

iOS15 对 HealthKit 的后台交付触发逻辑做了不兼容调整，旧版iOS的固定时间触发逻辑已废弃，调整为数据变更触发+频率阈值限制，仅当你监听的体征类型有新数据产生时，才会按照你设置的频率（如每小时）触发回调，无新数据时不会到点空推。

排查&修复步骤 #

• 确认权限逻辑：调用enableBackgroundDelivery前必须显式请求对应数据类型的读权限，不要复用历史授权状态，每次App启动时先调用requestAuthorization(toShare:read:completion:)确认步数读权限已授权，再执行观察者注册逻辑
• 持有观察者对象：iOS15 中HKObserverQuery如果是局部变量会被ARC提前释放，需要将query声明为所在类的强引用属性，不能作为方法内的局部变量
• 校验后台配置：确认Xcode的Signing&Capabilities中Background Modes已勾选「HealthKit updates」，同时Info.plist中已配置NSHealthShareUsageDescription和NSHealthUpdateUsageDescription对应的权限说明文案，iOS15对缺失说明的应用会直接静默回收HealthKit相关权限
• 调整触发验证逻辑：测试时需要主动产生新的步数数据（比如摇晃手机、模拟运动），等待至少1小时后验证回调是否触发，不要在无数据更新的场景下测试

修正后参考代码 #

// 类的属性，强持有HKObserverQuery
private var stepObserverQuery: HKObserverQuery?

private func startObservingStepCountChanges() {
    guard let sampleType = HKObjectType.quantityType(forIdentifier: HKQuantityTypeIdentifier.stepCount) else {
        print("获取步数类型失败")
        return
    }
    // 先请求权限，确保授权后再注册
    healthKitStore.requestAuthorization(toShare: nil, read: [sampleType]) { [weak self] granted, error in
        guard granted, error == nil else {
            print("步数权限未授权: \(error?.localizedDescription ?? "未知错误")")
            return
        }
        // 初始化query并存为全局属性
        let query = HKObserverQuery(sampleType: sampleType, predicate: nil, updateHandler: self?.stepChangeHandler)
        self?.stepObserverQuery = query
        self?.healthKitStore.execute(query)
        // 开启后台交付
        self?.healthKitStore.enableBackgroundDelivery(for: sampleType, frequency: .hourly) { succeeded, error in
            if succeeded {
                print("已开启步数后台更新交付")
            } else {
                print("开启步数后台更新失败: \(error?.localizedDescription ?? "未知错误")")
            }
        }
    }
}

private func stepChangeHandler(query: HKObserverQuery, completionHandler: @escaping HKObserverQueryCompletionHandler, error: Error?) {
    guard error == nil else {
        print("观察者查询出错: \(error!.localizedDescription)")
        completionHandler()
        return
    }
    print("后台更新回调触发")
    fireTestPush()           
    completionHandler()
}

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