watchOS中HKWorkoutSession运行异常，实时获取心率值技术问询

我来帮你梳理这两个问题的解决思路，都是watchOS健康开发中常见的坑：

一、HKWorkoutSession运行不稳定的排查与修复 #

针对session不稳定的问题，你可以从这几个方向逐一排查：

• 权限与授权检查：确保已经正确请求了HKWorkoutType和心率相关的健康数据权限，并且用户已授权。在初始化健康存储后，一定要调用HKHealthStore.requestAuthorization(toShare:read:completion:)，同时确认readTypes包含.heartRate和.workout。
• 生命周期与状态监听：watchOS的workout session对生命周期非常敏感，要在WKInterfaceController的willActivate/didDeactivate中合理管理session的启停。同时务必实现HKWorkoutSessionDelegate的所有关键回调，比如workoutSession(_:didFailWithError:)来捕捉异常，workoutSession(_:didChangeTo:from:date:)来处理状态切换（比如后台、暂停等场景）。
• 后台模式配置：在Xcode的watchOS Target设置中，开启Background Modes里的Workout processing选项。没有这个配置，系统会在app进入后台后很快终止session。
• 参数正确性：确认workout session的activityType和locationType匹配实际场景，比如室内跑步不要设为.outdoor，错误的参数可能导致session异常中断。

二、实时获取心率的代码完善 #

你给出的HKAnchoredObjectQuery方向是对的，但需要补全关键逻辑，同时和workout session联动：

完整的心率查询代码 #

import HealthKit

class WorkoutController: WKInterfaceController, HKWorkoutSessionDelegate {
    let healthStore = HKHealthStore()
    var heartRateQuery: HKAnchoredObjectQuery?
    var anchor: HKQueryAnchor?
    var workoutSession: HKWorkoutSession?

    // 启动心率查询的方法
    func startHeartRateQuery(updateHandler: @escaping ([HKQuantitySample]?) -> Void) {
        guard let heartRateType = HKObjectType.quantityType(forIdentifier: .heartRate) else {
            print("心率数据类型不可用")
            return
        }

        // 先检查权限是否已授权
        guard healthStore.authorizationStatus(for: heartRateType) == .sharingAuthorized else {
            print("未获得心率读取权限，请先授权")
            return
        }

        // 初始化锚点查询
        let query = HKAnchoredObjectQuery(
            type: heartRateType,
            predicate: nil,
            anchor: anchor,
            limit: Int(HKObjectQueryNoLimit)
        )

        // 初始数据加载回调
        query.completionHandler = { [weak self] _, samples, _, newAnchor, error in
            guard let self = self else { return }
            if let error = error {
                print("心率查询初始化失败: \(error.localizedDescription)")
                return
            }
            self.anchor = newAnchor
            updateHandler(samples)
        }

        // 实时更新回调（关键！没有这个就拿不到实时数据）
        query.updateHandler = { [weak self] _, samples, _, newAnchor, error in
            guard let self = self else { return }
            if let error = error {
                print("心率实时更新失败: \(error.localizedDescription)")
                return
            }
            self.anchor = newAnchor
            updateHandler(samples)
        }

        self.heartRateQuery = query
        healthStore.execute(query)
    }

    // 配合WorkoutSession的启停逻辑
    func workoutSession(_ session: HKWorkoutSession, didChangeTo toState: HKWorkoutSessionState, from fromState: HKWorkoutSessionState, date: Date) {
        switch toState {
        case .running:
            // 当workout开始运行时启动心率查询
            startHeartRateQuery { [weak self] samples in
                guard let self = self else { return }
                self.handleHeartRateSamples(samples)
            }
        case .paused, .ended:
            // 暂停或结束时取消查询，节省资源
            if let query = self.heartRateQuery {
                self.healthStore.stop(query)
                self.heartRateQuery = nil
            }
        default:
            break
        }
    }

    // 处理心率样本，转换为可读数值
    private func handleHeartRateSamples(_ samples: [HKQuantitySample]?) {
        guard let samples = samples else { return }
        let heartRateUnit = HKUnit.count().unitDivided(by: HKUnit.minute())
        for sample in samples {
            let heartRate = sample.quantity.doubleValue(for: heartRateUnit)
            print("实时心率: \(Int(heartRate)) bpm")
            // 这里可以更新UI显示心率
        }
    }

    // 其他WorkoutSession相关代码...
}

关键注意事项 #

• 与WorkoutSession联动：不要提前启动心率查询，最好在session进入.running状态时再启动，结束时停止，避免和session的资源竞争。
• 单位转换：心率数据存储的是count/min，必须用对应的HKUnit转换才能得到正确的bpm数值。
• 内存管理：所有闭包中都要用weak self避免循环引用，防止控制器无法释放，间接影响session稳定性。

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