Objective-C下HealthKit日步数统计匹配健康APP数据求助

我太懂你这种纠结了——明明调了HealthKit的接口，查出来的步数却和系统健康APP对不上，试了好几种谓词都没用对吧？其实问题出在你用了普通的样本查询自己统计，而没有用HealthKit专门做聚合统计的API，系统健康APP的步数统计是会自动处理跨天样本的拆分的，这是你之前的方法没覆盖到的点。

下面直接给你能和健康APP数据完全对齐的Objective-C代码，分两种场景：查询指定某天的步数，以及查询连续多天的每日步数统计。

第一步：先搞定HealthKit权限 #

首先得确保你的APP有HealthKit的访问权限，先导入框架，然后请求步数的读取权限：

#import <HealthKit/HealthKit.h>

@interface YourViewController ()
@property (nonatomic, strong) HKHealthStore *healthStore;
@end

@implementation YourViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    [self setupHealthKitAuthorization];
}

- (void)setupHealthKitAuthorization {
    // 先检查设备是否支持HealthKit（比如iPad就不支持）
    if (![HKHealthStore isHealthDataAvailable]) {
        NSLog(@"当前设备不支持HealthKit");
        return;
    }
    
    self.healthStore = [[HKHealthStore alloc] init];
    
    // 定义要读取的步数类型
    HKQuantityType *stepCountType = [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierStepCount];
    NSSet *readPermissions = [NSSet setWithObject:stepCountType];
    
    // 请求权限
    [self.healthStore requestAuthorizationToShareTypes:nil readTypes:readPermissions completion:^(BOOL success, NSError * _Nullable error) {
        if (success) {
            NSLog(@"HealthKit步数读取权限已获取");
            // 权限拿到后就可以调用查询方法了，比如查今天的步数
            [self queryStepCountForSpecificDate:[NSDate date]];
            // 或者查最近7天的每日步数
            // [self queryDailyStepCountsForLast7Days];
        } else {
            NSLog(@"权限请求失败：%@", error.localizedDescription);
        }
    }];
}

场景1：查询指定某天的步数（和健康APP完全一致） #

这个方法用HKStatisticsQuery，它会自动帮你聚合当天所有步数，包括处理跨天的样本：

- (void)queryStepCountForSpecificDate:(NSDate *)targetDate {
    HKQuantityType *stepCountType = [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierStepCount];
    NSCalendar *calendar = [NSCalendar currentCalendar];
    
    // 关键：把目标日期转换成当天0点到次日0点的时间范围（用系统时区，避免时区偏差）
    NSDateComponents *dateComponents = [calendar components:NSCalendarUnitYear | NSCalendarUnitMonth | NSCalendarUnitDay 
                                                   fromDate:targetDate];
    dateComponents.hour = 0;
    dateComponents.minute = 0;
    dateComponents.second = 0;
    NSDate *dayStartDate = [calendar dateFromComponents:dateComponents];
    
    // 次日0点作为结束时间
    dateComponents.day += 1;
    NSDate *dayEndDate = [calendar dateFromComponents:dateComponents];
    
    // 创建统计查询：累加当天所有步数
    HKStatisticsQuery *stepQuery = [[HKStatisticsQuery alloc] initWithQuantityType:stepCountType
                                                               quantitySamplePredicate:[HKQuery predicateForSamplesWithStartDate:dayStartDate 
                                                                                                                         endDate:dayEndDate 
                                                                                                                        options:HKQueryOptionStrictEndDate]
                                                                                 options:HKStatisticsOptionCumulativeSum];
    
    // 处理查询结果
    stepQuery.statisticsHandler = ^(HKStatisticsQuery *query, HKStatistics *result, NSError *error) {
        if (error) {
            NSLog(@"步数查询失败：%@", error.localizedDescription);
            return;
        }
        
        HKQuantity *totalStepsQuantity = result.sumQuantity;
        if (totalStepsQuantity) {
            // 把HKQuantity转换成整数步数
            NSInteger totalSteps = [totalStepsQuantity doubleValueForUnit:[HKUnit countUnit]];
            
            // 格式化日期方便显示
            NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];
            dateFormatter.dateFormat = @"yyyy-MM-dd";
            NSString *dateStr = [dateFormatter stringFromDate:targetDate];
            
            NSLog(@"[%@] 当日总步数：%ld", dateStr, (long)totalSteps);
            // 这里可以把结果回调到主线程更新UI
            dispatch_async(dispatch_get_main_queue(), ^{
                // 更新UI的代码
            });
        } else {
            NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];
            dateFormatter.dateFormat = @"yyyy-MM-dd";
            NSString *dateStr = [dateFormatter stringFromDate:targetDate];
            NSLog(@"[%@] 无步数数据", dateStr);
        }
    };
    
    // 执行查询
    [self.healthStore executeQuery:stepQuery];
}

场景2：查询连续多天的每日步数统计 #

如果需要查最近N天的每日步数，用HKStatisticsCollectionQuery更高效，它会自动按天分组统计：

- (void)queryDailyStepCountsForLast7Days {
    HKQuantityType *stepCountType = [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierStepCount];
    NSCalendar *calendar = [NSCalendar currentCalendar];
    
    // 设置查询范围：最近7天（今天往前推6天）
    NSDate *endDate = [NSDate date];
    NSDateComponents *pastComponents = [[NSDateComponents alloc] init];
    pastComponents.day = -6;
    NSDate *startDate = [calendar dateByAddingComponents:pastComponents toDate:endDate options:0];
    
    // 设置按天分组的间隔
    NSDateComponents *dayInterval = [[NSDateComponents alloc] init];
    dayInterval.day = 1;
    
    // 创建统计集合查询
    HKStatisticsCollectionQuery *collectionQuery = [[HKStatisticsCollectionQuery alloc] initWithQuantityType:stepCountType
                                                                                     quantitySamplePredicate:nil
                                                                                                     options:HKStatisticsOptionCumulativeSum
                                                                                               anchorDate:startDate
                                                                                          intervalComponents:dayInterval];
    
    // 处理初始结果
    collectionQuery.initialResultsHandler = ^(HKStatisticsCollectionQuery *query, HKStatisticsCollection *results, NSError *error) {
        if (error) {
            NSLog(@"步数统计查询失败：%@", error.localizedDescription);
            return;
        }
        
        // 遍历每天的统计结果
        [results enumerateStatisticsFromDate:startDate toDate:endDate withBlock:^(HKStatistics *statistics, BOOL *stop) {
            HKQuantity *sumQuantity = statistics.sumQuantity;
            NSDate *dayDate = statistics.startDate;
            
            NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];
            dateFormatter.dateFormat = @"yyyy-MM-dd";
            NSString *dateStr = [dateFormatter stringFromDate:dayDate];
            
            if (sumQuantity) {
                NSInteger stepCount = [sumQuantity doubleValueForUnit:[HKUnit countUnit]];
                NSLog(@"[%@] 步数：%ld", dateStr, (long)stepCount);
            } else {
                NSLog(@"[%@] 无步数数据", dateStr);
            }
        }];
        
        // 如果需要实时更新数据（比如用户在健康APP里新增了步数），可以设置更新回调
        collectionQuery.statisticsUpdateHandler = ^(HKStatisticsCollectionQuery *query, HKStatistics *statistics, HKStatisticsCollection *results, BOOL stop) {
            // 处理实时更新的逻辑
        };
    };
    
    // 执行查询
    [self.healthStore executeQuery:collectionQuery];
}

@end

为什么你之前的方法不对？ #

你之前用HKSampleQuery获取所有样本再自己筛选求和，最大的问题是跨天样本的处理：比如某个步数样本的开始时间是当天23:59，结束时间是次日00:01，这部分步数健康APP会拆分成两天分别统计，但你自己筛选的话会把整个样本算到前一天或者后一天，导致数据和健康APP不一致。而HKStatisticsQuery和HKStatisticsCollectionQuery是HealthKit专门为聚合统计设计的API，内部会自动处理这种跨天样本的拆分，完全对齐系统健康APP的统计逻辑。

另外，之前你用的predicateForSamplesWithStartDate:endDate:options:HKQueryOptionStrictEndDate其实是正确的样本筛选谓词，但只有搭配统计查询才能发挥作用，单独用来获取样本自己统计是不行的。

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