Swift中使用HealthKit无法获取跑步数据的问题求助

问题根源 #

1. 跑步类型的子分类遗漏：HealthKit把跑步拆成了「户外跑步」「室内跑步」和通用的「跑步」三个类型，只用.running作为查询条件，可能只匹配到了通用类型，漏掉另外两种子类型的记录，导致循环内仅能打印少量数据，循环外因变量未正确保留而无法读取。骑行没有这类细分，.cycling能匹配所有骑行记录，所以正常。
2. 异步查询的时机问题：HealthKit查询是后台异步执行的，如果调用fetchRunningData后立刻在函数外打印数据，此时查询还未完成，自然读不到；循环内是在查询完成的回调里执行，所以能看到数据。骑行数据可能因查询速度快或测试时回调刚好完成，导致循环外也能读取。
3. 变量作用域问题：如果存储跑步数据的是函数内的局部变量，回调结束后变量就会被释放，循环外自然访问不到；骑行数据可能用了全局变量或类属性存储，所以无此问题。

解决步骤 #

1. 补全跑步类型的查询条件 #

把所有跑步相关类型加入查询，确保覆盖健康库中所有跑步记录：

// 包含所有跑步子类型
let runningActivityTypes: Set<HKWorkoutActivityType> = [.running, .indoorRunning, .outdoorRunning]
let activityPredicate = HKQuery.predicateForWorkouts(with: runningActivityTypes)

2. 确保异步回调后再访问数据 #

HealthKit查询是异步执行的，必须在查询的completion回调里处理数据，或用闭包、通知等方式通知数据准备完成，不要在调用查询函数后立刻读取数据：

func fetchRunningData(completion: @escaping ([HKWorkout]?) -> Void) {
    let healthStore = HKHealthStore()
    let runningTypes: Set<HKWorkoutActivityType> = [.running, .indoorRunning, .outdoorRunning]
    let activityPredicate = HKQuery.predicateForWorkouts(with: runningTypes)
    let datePredicate = HKQuery.predicateForSamples(
        withStart: Calendar.current.date(byAdding: .day, value: -30, to: Date())!,
        end: Date(),
        options: .strictStartDate
    )
    let finalPredicate = NSCompoundPredicate(andPredicateWithSubpredicates: [activityPredicate, datePredicate])
    
    let query = HKSampleQuery(
        sampleType: HKObjectType.workoutType(),
        predicate: finalPredicate,
        limit: HKObjectQueryNoLimit,
        sortDescriptors: [NSSortDescriptor(key: HKSampleSortIdentifierStartDate, ascending: false)]
    ) { _, samples, error in
        guard let workouts = samples as? [HKWorkout], error == nil else {
            completion(nil)
            return
        }
        // 回调里返回数据
        completion(workouts)
    }
    healthStore.execute(query)
}

// 调用方式：在回调内处理数据
fetchRunningData { workouts in
    guard let workouts = workouts else { return }
    print("总跑步记录数: \(workouts.count)")
    // 循环内打印
    for workout in workouts {
        print("跑步记录: \(workout.startDate), 类型: \(workout.activityType.rawValue)")
    }
    // 循环外正常访问数据（在回调内）
    DispatchQueue.main.async {
        print("循环外访问记录数: \(workouts.count)")
    }
}

3. 用类属性存储数据（可选） #

如果需要在多个地方访问跑步数据，在HealthManager类中声明类属性存储：

class HealthManager {
    let healthStore = HKHealthStore()
    var savedRunningWorkouts: [HKWorkout] = []
    
    func fetchRunningData() {
        // 省略查询条件构建逻辑
        let query = HKSampleQuery(...) { _, samples, error in
            guard let workouts = samples as? [HKWorkout], error == nil else { return }
            self.savedRunningWorkouts = workouts
            // 发送通知告知数据更新
            NotificationCenter.default.post(name: NSNotification.Name("RunningDataUpdated"), object: nil)
        }
        healthStore.execute(query)
    }
}

之后在需要访问数据的地方监听通知，确保数据已完成赋值。

4. 检查权限配置 #

确认Info.plist中同时存在以下两个权限键：

• Privacy - Health Share Usage Description
• Privacy - Health Update Usage Description
  部分iOS版本要求同时声明这两个权限，才能完整读取Workout数据。

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