求助：HealthKit获取Apple Watch步数及卡路里数据与健康应用不一致

我们通过HealthKit从健康应用中获取每日步数及卡路里消耗数据，使用的类型定义如下：

stepCount = HKSampleType.quantityType(forIdentifier: HKQuantityTypeIdentifier.stepCount)

caloriesBurn = HKSampleType.quantityType(forIdentifier: .activeEnergyBurned)

并通过以下代码执行查询：

HKSampleQuery(sampleType: <stepCount or caloriesBurn>, predicate: last24hPredicate, limit: HKObjectQueryNoLimit, sortDescriptors: nil)

遇到的问题：仅使用iPhone记录活动时，获取的步数及卡路里数据与健康应用完全一致；但使用Apple Watch记录活动时，数据始终不匹配。多数用户使用手表追踪活动，数据不一致的情况无法接受，需要让应用显示与健康应用完全一致的步数、卡路里数据。

附数据对比截图：

• 健康应用中的步数
  
• 健身应用中的步数及卡路里消耗
  
• 我方应用中的步数及卡路里消耗
  

1. 改用HKStatisticsQuery替代HKSampleQuery #

健康应用展示的是聚合后的统计数据，而HKSampleQuery获取的是原始采样数据，当多设备（iPhone+Apple Watch）同时记录时，直接累加原始样本可能出现重复计算、数据未合并的问题。HKStatisticsQuery会自动遵循HealthKit的官方聚合逻辑，和健康应用的计算结果保持一致。

步数查询示例：

import HealthKit

let healthStore = HKHealthStore()
let stepType = HKQuantityType.quantityType(forIdentifier: .stepCount)!

// 定义和健康应用"今日"一致的时间范围：当日0点到当前时间
let calendar = Calendar.current
let startDate = calendar.startOfDay(for: Date())
let endDate = Date()

// 创建查询谓词
let predicate = HKQuery.predicateForSamples(withStart: startDate, end: endDate, options: .strictStartDate)

// 创建统计查询，计算累计总和
let statisticsQuery = HKStatisticsQuery(quantityType: stepType, quantitySamplePredicate: predicate, options: .cumulativeSum) { query, result, error in
    guard let result = result, let sumQuantity = result.sumQuantity() else {
        if let error = error {
            print("步数查询错误: \(error.localizedDescription)")
        }
        return
    }
    // 获取步数数值
    let totalSteps = sumQuantity.doubleValue(for: HKUnit.count())
    // 回到主线程更新UI
    DispatchQueue.main.async {
        // 更新你的UI展示，例如：
        // self.stepLabel.text = "\(Int(totalSteps))步"
    }
}

// 执行查询
healthStore.execute(statisticsQuery)

活动卡路里查询示例：

let calorieType = HKQuantityType.quantityType(forIdentifier: .activeEnergyBurned)!
let caloriePredicate = HKQuery.predicateForSamples(withStart: startDate, end: endDate, options: .strictStartDate)

let calorieQuery = HKStatisticsQuery(quantityType: calorieType, quantitySamplePredicate: caloriePredicate, options: .cumulativeSum) { query, result, error in
    guard let result = result, let sumQuantity = result.sumQuantity() else {
        if let error = error {
            print("卡路里查询错误: \(error.localizedDescription)")
        }
        return
    }
    // 卡路里单位使用 kilocalorie（大卡）
    let totalCalories = sumQuantity.doubleValue(for: HKUnit.kilocalorie())
    DispatchQueue.main.async {
        // 更新UI，例如：
        // self.calorieLabel.text = "\(Int(totalCalories))大卡"
    }
}

healthStore.execute(calorieQuery)

2. 检查设备过滤与权限设置 #

• 确认你的last24hPredicate没有添加设备过滤条件，避免排除Apple Watch的数据源；
• 检查Info.plist中HealthKit权限配置是否完整，确保用户授权了读取stepCount和activeEnergyBurned的权限，且允许读取所有设备的数据。

3. 验证时间范围一致性 #

确保查询的时间范围和健康应用的"今日"范围完全匹配：从当日0点开始到当前时间，避免因时区、日期计算偏差导致数据差异。

内容的提问来源于stack exchange，提问作者RUDRA S M