Apple HealthKit睡眠数据获取不准确的问题排查及优化求助

嗨，我看了你遇到的HealthKit睡眠数据不准的问题，结合你的代码和描述，整理了几个核心原因和优化方向，应该能帮你定位问题：

核心问题1：只取了单条睡眠阶段记录，而非完整睡眠周期 #

你的代码里设置了limit: 1，这只会获取最新的一条睡眠阶段数据，但HealthKit的睡眠记录是按「睡眠阶段」拆分存储的——比如一整晚的睡眠会被拆成「浅睡、深睡、短暂清醒、REM睡眠」等多个独立的HKCategorySample。如果刚好取到的是最后一段清醒的记录，那计算出来的时长自然和实际睡眠差很多。

而且你直接用单条sample的startDate和endDate计算总时长，完全忽略了中间可能存在的清醒时段，这也是数据不准的关键原因。

核心问题2：未区分睡眠状态与清醒/卧床状态 #

你提到asleep已被废弃，现在HealthKit把睡眠状态拆成了更细分的类型：.asleepDeep、.asleepCore、.asleepREM、.asleepUnspecified，而.awake（清醒）、.inBed（卧床未睡）不属于有效睡眠时间，你的代码没有过滤这些状态，会把非睡眠时间也算进去。

优化方案及代码调整 #

针对以上问题，我修改了你的代码，核心调整点包括：

1. 取消limit限制，获取指定时间范围内的所有睡眠阶段记录
2. 过滤出真正属于「睡眠状态」的阶段，累加其时长
3. 增加时间范围过滤，精准获取最近一晚的睡眠数据

func fetchSleepData(completion: @escaping (String) -> Void) {
    guard let sleepType = HKObjectType.categoryType(forIdentifier: .sleepAnalysis) else {
        completion("0 hours 0m")
        return
    }

    // 辅助函数：判断是否为有效睡眠状态
    func isSleepState(_ value: HKCategoryValueSleepAnalysis) -> Bool {
        switch value {
        case .asleepUnspecified, .asleepDeep, .asleepCore, .asleepREM:
            return true
        case .awake, .inBed:
            return false
        @unknown default:
            return false
        }
    }

    // 设置时间范围：获取昨天0点到今天0点的睡眠（覆盖跨午夜的睡眠周期）
    let calendar = Calendar.current
    let today = calendar.startOfDay(for: Date())
    guard let yesterday = calendar.date(byAdding: .day, value: -1, to: today) else {
        completion("0 hours 0m")
        return
    }
    let predicate = HKQuery.predicateForSamples(withStart: yesterday, end: today, options: .strictStartDate)

    // 按开始时间升序排序，确保按睡眠顺序累加
    let sortDescriptor = NSSortDescriptor(key: HKSampleSortIdentifierStartDate, ascending: true)
    let query = HKSampleQuery(
        sampleType: sleepType,
        predicate: predicate,
        limit: HKObjectQueryNoLimit,  // 获取所有符合条件的记录
        sortDescriptors: [sortDescriptor]
    ) { (query, samples, error) in
        if let error = error {
            print("Error fetching sleep data: \(error.localizedDescription)")
            completion("Error")
            return
        }

        guard let samples = samples as? [HKCategorySample] else {
            completion("No sleep data")
            return
        }

        // 累加所有有效睡眠阶段的时长
        var totalSleepDuration: TimeInterval = 0
        for sample in samples {
            guard let sleepValue = HKCategoryValueSleepAnalysis(rawValue: sample.value) else { continue }
            if isSleepState(sleepValue) {
                totalSleepDuration += sample.endDate.timeIntervalSince(sample.startDate)
            }
        }

        let hours = Int(totalSleepDuration) / 3600
        let minutes = Int(totalSleepDuration) / 60 % 60
        let formattedSleepDuration = "\(hours) hours \(minutes)m"
        completion(formattedSleepDuration)
    }

    healthStore.execute(query)
}

其他排查方向 #

如果调整后数据还是不准，可以检查以下几点：

• 权限验证：确认你的App已正确申请睡眠数据的读取权限，有时候权限未完全授予会导致只能获取部分数据
• 数据来源过滤：HealthKit可能同时存在手动输入、第三方App、Apple Watch等多来源数据，可以通过HKQuery.predicateForObjects(from: [指定来源])过滤，比如只取Apple Watch的监测数据
• 时区问题：确保时间范围的计算考虑了用户的时区，避免因时区偏移导致睡眠数据被排除在查询范围外

备注：内容来源于stack exchange，提问作者Custy