Apple Watch监听Workout App训练完成的HKObserverQuery不触发问题

样本类型正确性确认 #

你选用的.workoutType()样本类型完全符合需求，系统自带Workout App在结束训练后，确实会向HealthKit写入该类型的样本，苹果官方文档的对应说明是正确的。

触发失败的常见原因及修复方案 #

• 权限配置遗漏
  即使你已经添加了HealthKit后台交付的Entitlements，也需要确保代码中明确申请了读取Workout类型数据的权限。检查requestAuthorization(toShare:read:)方法的调用参数，read数组必须包含.workoutType()，仅申请写入权限无法触发查询回调。
• 查询注册时机错误
  HKObserverQuery必须在Watch Extension的生命周期早期注册，比如ExtensionDelegate.applicationDidFinishLaunching方法（UIKit架构）或者SwiftUI App的初始化方法中，不能延迟到页面视图加载时才注册，否则后台唤醒时查询未初始化，无法接收回调。
• 未正确调用回调完成方法
  你当前的代码中，updateHandler的completionHandler()被注释在业务逻辑闭包内，哪怕是测试阶段注释了业务代码，也必须要调用completionHandler()告知HealthKit事件处理完成，否则系统会认为你的应用未处理成功，后续会停止推送更新事件。
• 应用被强制退出
  watchOS中如果用户手动上滑强制退出应用，所有HealthKit后台交付都会被暂停，必须用户重新打开应用后才会恢复，测试过程中不要强制退出应用。

优化建议 #

如果仅需要监听训练完成事件，可以添加谓词过滤未结束的训练，减少不必要的触发：

let workoutEndPredicate = NSPredicate(format: "endDate != nil")
let query = HKObserverQuery(sampleType: .workoutType(), predicate: workoutEndPredicate, updateHandler: { [weak self] _, completionHandler, error in
    guard error == nil else {
        // 错误处理逻辑
        completionHandler()
        return
    }
    // 业务逻辑：后台更新、刷新Complication
    completionHandler() // 必须调用，告知系统处理完成
})

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