HealthKit在模拟器可更新示例数据但Apple Watch实机无实时运动数据更新

1. 代码逻辑硬伤（首当其冲的bug） #

你当前HKLiveWorkoutBuilderDelegate回调的处理逻辑存在致命错误：当遍历collectedTypes时，如果遇到第一个非HKQuantityType的样本类型，会直接执行return终止整个遍历流程，后续所有类型（包括心率）都不会被处理。
模拟器运行正常是因为模拟器返回的采集类型队列第一个就是心率类型，而实机上会优先返回运动事件、状态变更等其他类型，直接触发return，导致心率数据永远不会被处理。

修复代码： #

extension WorkoutManager: HKLiveWorkoutBuilderDelegate {
    func workoutBuilderDidCollectEvent(_ workoutBuilder: HKLiveWorkoutBuilder) {
    }

    func workoutBuilder(_ workoutBuilder: HKLiveWorkoutBuilder, didCollectDataOf collectedTypes: Set<HKSampleType>) {
        for type in collectedTypes {
            guard let quantityType = type as? HKQuantityType else {
                continue // 改为continue，仅跳过当前非数量类型，继续遍历其他类型
            }

            let statistics = workoutBuilder.statistics(for: quantityType)
            updateForStatistics(statistics)
        }
    }
}

2. 缺失必要的项目配置 #

watchOS实机运行HealthKit运动采集必须添加对应的权限配置，否则会静默失败：

• 在Xcode的watchOS Target的Signing & Capabilities中添加Workout Processing能力，这是后台运动采集的必要权限
• 在watchOS Target的Info.plist中添加以下隐私描述：
  • NSHealthShareUsageDescription：写入健康数据的用途说明
  • NSHealthUpdateUsageDescription：读取健康数据的用途说明
  • 如果你使用的是户外运动配置，还需要添加NSLocationWhenInUseUsageDescription位置权限说明

3. 权限校验补充 #

你当前的requestAuthorization方法没有处理授权失败的情况，实机上如果用户拒绝了健康权限，数据采集会直接失效，建议添加授权状态校验：

func requestAuthorization() {
    let typesToShare: Set = [HKQuantityType.workoutType()]
    let typesToRead: Set = [
        HKQuantityType.quantityType(forIdentifier: .heartRate)!,
        HKObjectType.activitySummaryType()
    ]

    healthStore.requestAuthorization(toShare: typesToShare, read: typesToRead) { success, error in
        DispatchQueue.main.async {
            if let error = error {
                print("健康权限请求失败: \(error.localizedDescription)")
                return
            }
            if !success {
                print("用户拒绝了健康权限，请在系统设置中开启")
            }
        }
    }
}

实机测试注意事项 #

• 确保手表没有开启低电量模式，低电量模式会关闭心率实时采集
• 手表佩戴贴合，避免心率传感器无法正常读取数据
• 进入系统设置「隐私与安全性-健康」，确认你的应用已经开启了心率读取权限
• 首次启动时要等待权限请求弹窗弹出，授权完成后再开始运动

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