使用HealthKit查询用户前24小时睡眠时长无数据问题排查

以下是针对你遇到的睡眠数据查询无结果问题的具体排查方向和修改建议：

1. 睡眠状态类型判断不全 #

你的代码仅统计了asleepUnspecified类型的睡眠数据，但HealthKit的睡眠分析包含多种细分状态（深度睡眠、核心睡眠、REM睡眠等），这些状态的rawValue与asleepUnspecified不同，会被直接忽略。

修改睡眠状态判断逻辑，将所有睡眠相关状态纳入统计：

// 定义所有睡眠状态的rawValue集合
let validSleepValues = [
    HKCategoryValueSleepAnalysis.asleepUnspecified.rawValue,
    HKCategoryValueSleepAnalysis.asleepDeep.rawValue,
    HKCategoryValueSleepAnalysis.asleepCore.rawValue,
    HKCategoryValueSleepAnalysis.asleepREM.rawValue
]

for result in results {
    if validSleepValues.contains(result.value) {
        let sleepDuration = result.endDate.timeIntervalSince(result.startDate)
        print("Sample start: \(result.startDate), end: \(result.endDate), value: \(result.value), duration: \(sleepDuration) seconds")
        totalSleepTime += sleepDuration
    }
}

2. 日期范围的时区偏差 #

控制台打印的日期为UTC时区，但设备的睡眠数据是按本地时区存储的，可能导致查询范围未覆盖实际睡眠时间段。

调整谓词构建逻辑，明确指定本地时区：

let calendar = Calendar.current
let endDate = Date()
let startDate = calendar.date(byAdding: .day, value: -1, to: endDate)!

// 构建谓词时指定本地时区
let predicate = HKQuery.predicateForSamples(
    withStart: startDate,
    end: endDate,
    options: .strictStartDate,
    timeZone: calendar.timeZone
)

同时可以对比健康APP内的睡眠数据时间，确认查询的UTC时间范围是否与本地时间存在偏差。

3. HKHealthStore实例不统一 #

你在授权代码和查询函数中分别创建了HKHealthStore实例，虽然理论上不影响，但建议全局使用同一个实例，避免潜在的权限会话问题：

// 在类或全局级别定义HKHealthStore实例
let healthStore = HKHealthStore()

func fetchSleepData(completion: @escaping (TimeInterval?) -> Void) {
    // 直接使用全局实例，不再新建
    let calendar = Calendar.current
    // ... 后续代码保持不变
}

4. 主动验证权限与数据范围 #

即使授权弹窗通过，也可以主动检查睡眠数据的读取权限状态：

let sleepType = HKObjectType.categoryType(forIdentifier: .sleepAnalysis)!
if healthStore.authorizationStatus(for: sleepType) != .sharingAuthorized {
    print("睡眠数据读取权限未正确授权")
    completion(nil)
    return
}

另外可以尝试扩大查询范围（比如查询过去7天），验证是否是24小时范围内确实无数据的特殊情况。

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