添加NSCompoundPredicate后HealthKit步数统计函数失效排查

你的代码添加非手动录入数据过滤后无法统计步数，核心问题在于元数据谓词写法不符合HealthKit规范，同时存在几个潜在边界问题，以下是具体分析和修复步骤：

1. 核心问题：元数据谓词格式错误 #

你当前使用的过滤谓词写法错误，且未考虑自动采集样本的元数据特性：

.init(format: "metadata.%K == NO", HKMetadataKeyWasUserEntered)

• HealthKit中访问元数据的正确键路径需用HKPredicateKeyPathMetadata构造，而非直接拼接metadata.；
• 自动采集的步数样本大概率没有HKMetadataKeyWasUserEntered字段（仅手动录入的样本会添加该字段并设为YES），直接判断== NO会把所有无该字段的自动样本排除。

正确的非手动样本过滤逻辑应该是：无该字段 或 字段值为NO，对应的谓词写法：

let manualEntryPredicate = NSPredicate(
    format: "%K != YES OR %K == nil",
    HKPredicateKeyPathMetadata(HKMetadataKeyWasUserEntered),
    HKPredicateKeyPathMetadata(HKMetadataKeyWasUserEntered)
)

2. 完整修复后的calculateSteps函数 #

结合上述修改，同时处理startDate可能为nil的边界情况，修复后的代码如下：

func calculateSteps(completion: @escaping (HKStatisticsCollection?)-> Void) {
    guard let stepType = HKQuantityType.quantityType(forIdentifier: .stepCount) else {
        completion(nil)
        return
    }
    
    // 确保起始日期不为nil，避免查询失败
    guard let startDate = Calendar.current.date(byAdding: .day, value: -7, to: Date()) else {
        completion(nil)
        return
    }
    
    let anchorDate = Date.mondayAt12AM()
    let daily = DateComponents(day: 1)
    
    let datePredicate = HKQuery.predicateForSamples(
        withStart: startDate,
        end: Date(),
        options: .strictStartDate
    )
    
    // 正确过滤非手动录入的步数样本
    let manualEntryPredicate = NSPredicate(
        format: "%K != YES OR %K == nil",
        HKPredicateKeyPathMetadata(HKMetadataKeyWasUserEntered),
        HKPredicateKeyPathMetadata(HKMetadataKeyWasUserEntered)
    )
    
    let compoundPredicate = NSCompoundPredicate(andPredicateWithSubpredicates: [manualEntryPredicate, datePredicate])
    
    query = HKStatisticsCollectionQuery(
        quantityType: stepType,
        quantitySamplePredicate: compoundPredicate,
        options: .cumulativeSum,
        anchorDate: anchorDate,
        intervalComponents: daily
    )
    
    query!.initialResultsHandler = { query, statisticsCollection, error in
        // 添加错误日志，方便后续排查问题
        if let error = error {
            print("步数查询失败：\(error.localizedDescription)")
        }
        completion(statisticsCollection)
    }
    
    if let healthStore = healthStore, let query = self.query {
        healthStore.execute(query)
    }
}

3. 额外优化建议 #

• 在查询回调中加入错误打印，能快速定位权限、数据范围等其他潜在问题；
• 测试时可先移除元数据过滤谓词，确认基础步数查询正常后再逐步添加过滤逻辑，缩小排查范围；
• 检查Date.mondayAt12AM()的日历设置，避免因日历类型差异导致锚点日期偏差。

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