自定义Widget中从HealthKit获取体脂率（Body Fat Percentage）数据失败的解决方案咨询

嘿，我看你在自己的Widget里获取HealthKit数据时，体重和BMI都能正常拿到，但体脂率就是搞不定对吧？咱们来一步步排查解决这个问题：

1. 先检查权限配置——这大概率是核心问题 #

HealthKit对每个数据类型的权限都是单独管控的，你可能只申请了体重和BMI的访问权限，漏掉了体脂率的：

第一步：更新Info.plist的权限描述 #

在你的项目Info.plist里，确保添加了以下两个键（如果还没加的话），并且填写清晰的用途说明（iOS要求必须填，否则权限请求会失败）：

• NSHealthShareUsageDescription：比如“需要访问您的体脂率数据以在Widget中展示”
• NSHealthUpdateUsageDescription：如果你的APP需要写入体脂率数据的话，也要填对应的说明

第二步：请求权限时包含体脂率类型 #

在请求HealthKit权限的代码里，一定要把bodyFatPercentage加入到要读取的类型集合中：

// 建议把HealthStore实例做成单例，不要每次新建
let healthStore = HKHealthStore()

// 定义需要访问的数据类型集合
guard let bodyMass = HKObjectType.quantityType(forIdentifier: .bodyMass),
      let bodyMassIndex = HKObjectType.quantityType(forIdentifier: .bodyMassIndex),
      let bodyFatPercentage = HKObjectType.quantityType(forIdentifier: .bodyFatPercentage) else {
    fatalError("HealthKit数据类型不支持")
}

let typesToRead: Set<HKObjectType> = [bodyMass, bodyMassIndex, bodyFatPercentage]

// 请求权限
healthStore.requestAuthorization(toShare: nil, read: typesToRead) { success, error in
    DispatchQueue.main.async {
        if success {
            // 权限获取成功，现在可以执行数据查询了
        } else {
            // 处理权限被拒绝的情况，比如提示用户开启权限
        }
    }
}

2. 确认健康APP里有体脂率数据 #

如果健康APP里根本没有体脂率的记录，那你的查询自然会返回空数据。打开iPhone的「健康」APP，找到「体脂率」栏目，手动录入一条测试数据（比如30%），然后再运行你的代码试试。

3. 修正单位匹配问题 #

体脂率的单位是百分比，而你当前调用getSamples时用的是HKUnit.count()，这会导致数据解析出错。获取体脂率时要传入正确的单位：

// 在getTimeline里获取体脂率的代码应该改成这样：
ProfileDataStore.getSamples(for: bodyFatPercentage, unit: HKUnit.percent()) { (sample, error) in
    guard let sample = sample else { 
        // 处理数据为空或错误的情况
        return 
    }
    let entry = WeightEntry(date: currentDate, value: sample)
    let timeline = Timeline(entries: [ entry ], policy: .after(refreshDate))
    completion(timeline)
}

4. 优化HealthStore实例的使用 #

你当前在getMostRecentSample函数里每次都新建HKHealthStore()实例，这不是最佳实践，建议把它做成单例复用：

class ProfileDataStore {
    // 静态单例HealthStore实例
    static let healthStore = HKHealthStore()
    
    class func getMostRecentSample(for sampleType: HKSampleType, completion: @escaping (HKQuantitySample?, Error?) -> Void) {
        let mostRecentPredicate = HKQuery.predicateForSamples(withStart: Date.distantPast, end: Date(), options: .strictEndDate)
        let sortDescriptor = NSSortDescriptor(key: HKSampleSortIdentifierStartDate, ascending: false)
        let limit = 1
        
        let sampleQuery = HKSampleQuery(sampleType: sampleType, predicate: mostRecentPredicate, limit: limit, sortDescriptors: [sortDescriptor]) { (query, samples, error) in
            DispatchQueue.main.async {
                guard let samples = samples, let mostRecentSample = samples.first as? HKQuantitySample else {
                    completion(nil, error)
                    return
                }
                completion(mostRecentSample, nil)
            }
        }
        // 使用单例执行查询
        healthStore.execute(sampleQuery)
    }
}

按照这几步调整后，应该就能正常获取体脂率数据了。如果还是不行，可以检查一下健康APP里的体脂率数据是否是有效的（比如有没有正确的日期范围），或者在查询的时候打印error信息，看看具体的错误原因。

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