HKWorkoutSession活跃时Apple Watch意外休眠问题求助

问题描述 #

使用CMMotionManager获取加速度计数据，同时通过HKWorkoutSession获取训练数据并实时传输至iPhone，但Apple Watch会随机进入休眠状态。已配置WKBackgroundModes为workout-processing，表带佩戴紧实，此前用WatchKit实现相同功能无异常，改用SwiftUI后出现该问题。

定时器会打印当前时间，随机时刻输出停止，仅在点亮屏幕后恢复。根据Apple官方文档，开启workout-processing后应用应在后台持续运行，但实际未生效。

相关代码 #

do {
   let workoutConfiguration = HKWorkoutConfiguration()
   workoutConfiguration.activityType = .mindAndBody
   workoutConfiguration.locationType = .unknown
   self.session = try HKWorkoutSession(healthStore: self.healthStore, configuration: workoutConfiguration)
   self.builder = self.session?.associatedWorkoutBuilder()
   self.builder?.dataSource = HKLiveWorkoutDataSource(healthStore: self.healthStore, workoutConfiguration: workoutConfiguration)
   self.session?.delegate = self
   self.builder?.delegate = self
   // timer for update state
   self.timerHealth = Timer.scheduledTimer(timeInterval: 1, target: self, selector: #selector(self.getHealth), userInfo: nil, repeats: true)
   self.session?.startActivity(with: self.startDate)
   self.builder?.beginCollection(withStart: self.startDate) { (success, error) in
      guard success else {
          print(error?.localizedDescription)
          return
      }
    }
} catch {
   print(error.localizedDescription)
   return
}

可能的原因及解决方法 #

1. RunLoop定时器在SwiftUI后台环境不可靠 #

你用的Timer.scheduledTimer依赖主RunLoop，当Watch进入休眠或App后台挂起时，主RunLoop会被系统暂停，导致定时器停止——这是SwiftUI和WatchKit后台模型的核心差异，WatchKit Extension的后台调度逻辑和SwiftUI App模型不同。

修复方案：

• 优先用系统为 workout 场景提供的回调驱动数据获取：比如利用HKLiveWorkoutDataSource的代理方法接收健康数据更新，或者通过CMMotionManager的accelerometerUpdateInterval设置后的自动回调，这些都是系统优化过的后台触发机制，比Timer更稳定。
• 若必须保留定时逻辑，改用DispatchSourceTimer绑定到后台队列，脱离主RunLoop限制：

  let backgroundQueue = DispatchQueue.global(qos: .background)
  self.timerHealth = DispatchSource.makeTimerSource(queue: backgroundQueue)
  self.timerHealth.schedule(deadline: .now(), repeating: .seconds(1))
  self.timerHealth.setEventHandler { [weak self] in
      DispatchQueue.main.async {
          self?.getHealth()
      }
  }
  self.timerHealth.resume()
  

2. Workout Session状态管理缺失 #

SwiftUI生命周期和WatchKit不同，若未正确处理HKWorkoutSession的状态切换，系统可能误判训练已结束，进而挂起App。

修复方案：

• 完整实现HKWorkoutSessionDelegate的状态回调方法，确保session始终处于活跃状态：

  func workoutSession(_ workoutSession: HKWorkoutSession, didChangeTo toState: HKWorkoutSessionState, from fromState: HKWorkoutSessionState, date: Date) {
      switch toState {
      case .running:
          // 确保加速度计在session运行时持续更新
          self.motionManager?.allowsBackgroundAccelerometerUpdates = true
          self.motionManager?.startAccelerometerUpdates(to: .main) { data, error in
              // 处理加速度数据逻辑
          }
      case .paused:
          // 若不需要暂停功能，手动恢复session
          workoutSession.resume()
      default:
          break
      }
  }
  

• 仅在用户主动结束训练时，才调用builder?.endCollection()或session?.endActivity()，避免提前触发session结束。

3. 后台权限配置遗漏 #

除了WKBackgroundModes的workout-processing，还需补充以下配置：

• 在Info.plist中添加NSMotionUsageDescription（加速度计权限描述）、NSHealthShareUsageDescription、NSHealthUpdateUsageDescription（健康数据权限描述），且请求权限时需明确申请后台更新权限。
• 在WatchKit Extension的Info.plist中，设置WKAppBackgroundRefreshEnabled为YES，辅助维持后台活跃状态。
• 尝试更换workoutConfiguration.activityType，比如换成.other——部分场景下系统对运动类型的后台优先级有区分，.mindAndBody可能触发更严格的休眠策略。

4. CMMotionManager后台配置未开启 #

SwiftUI中需明确允许加速度计后台更新，否则系统会在休眠时停止数据采集：

• 调用motionManager?.allowsBackgroundAccelerometerUpdates = true，确保后台加速度计更新权限开启。
• 确保startAccelerometerUpdates在session启动后持续运行，直到session主动结束。

5. SwiftUI生命周期导致对象销毁 #

如果HKWorkoutSession、CMMotionManager等实例绑定到某个View的生命周期，当View被系统销毁时，这些实例也会被释放，导致后台运行中断。

修复方案：

• 将这些核心实例放在@StateObject或全局ObservableObject中，确保其生命周期与整个App一致，而非单个View。
• 避免在View的onAppear中初始化session，改为在App的init方法或专门的后台服务类中初始化，确保即使View被销毁，核心服务仍在运行。

内容的提问来源于stack exchange，提问作者Станислав Гичак