如何检测HKWorkoutSession在后台被强制关闭/结束

1. 确认后台模式配置 #

首先确保Xcode项目的Signing & Capabilities中开启Background Modes，并勾选Workout updates——这是应用在后台接收Workout事件的基础配置，没有这个，系统会限制后台的Workout相关回调。

2. 优化代理方法的后台处理 #

系统终止Workout Session时，HKWorkoutSessionDelegate的workoutSession(_:didChangeTo:from:date:)会触发状态变更为.ended，但后台下可能延迟回调。结合后台任务可以让你获得额外的处理时间：

func workoutSession(_ workoutSession: HKWorkoutSession, didChangeTo toState: HKWorkoutSessionState, from fromState: HKWorkoutSessionState, date: Date) {
    guard toState == .ended else { return }
    
    // 申请后台任务权限，确保处理逻辑能完成
    var backgroundTaskID: UIBackgroundTaskIdentifier = .invalid
    backgroundTaskID = UIApplication.shared.beginBackgroundTask(expirationHandler: {
        UIApplication.shared.endBackgroundTask(backgroundTaskID)
        backgroundTaskID = .invalid
    })
    
    // 在这里执行终止后的逻辑：比如保存 workout 数据、本地通知提醒等
    
    // 结束后台任务
    UIApplication.shared.endBackgroundTask(backgroundTaskID)
    backgroundTaskID = .invalid
}

同时实现didFailWithError方法，捕获意外终止的场景（比如系统强制断开Session）：

func workoutSession(_ workoutSession: HKWorkoutSession, didFailWithError error: Error) {
    guard let hkError = error as? HKError else { return }
    switch hkError.code {
    case .sessionWasDisconnected, .sessionFailed:
        // 处理Session被强制终止/断开的逻辑
        saveWorkoutData()
        sendLocalNotification()
    default:
        break
    }
}

3. 使用HKObserverQuery监听Workout状态 #

通过HKObserverQuery可以监听HealthKit中Workout数据的变化，即使应用在后台，当Workout被终止时也能触发回调：

func setupWorkoutObserver() {
    guard let workoutType = HKObjectType.workoutType() else { return }
    
    let observerQuery = HKObserverQuery(sampleType: workoutType, predicate: nil) { [weak self] _, completionHandler, _ in
        guard let self = self else {
            completionHandler()
            return
        }
        
        // 查询最新的Workout记录，判断状态
        let sortDescriptor = NSSortDescriptor(key: HKSampleSortIdentifierStartDate, ascending: false)
        let workoutQuery = HKSampleQuery(
            sampleType: workoutType,
            predicate: nil,
            limit: 1,
            sortDescriptors: [sortDescriptor]
        ) { _, samples, _ in
            if let latestWorkout = samples?.first as? HKWorkout, latestWorkout.state == .ended {
                self.handleWorkoutTermination(workout: latestWorkout)
            }
            completionHandler()
        }
        
        HKHealthStore.shared.execute(workoutQuery)
    }
    
    HKHealthStore.shared.execute(observerQuery)
}

记得在应用启动时调用这个方法，并且确保已获取HealthKit的读写权限。

4. 优先使用HKLiveWorkoutBuilder #

如果是iOS 14+，推荐使用HKLiveWorkoutBuilder替代传统的Workout Session管理，它在后台的稳定性更高，提供didCollect等实时回调，并且终止时的状态通知更及时。

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