如何调试Watch Connectivity？Apple Watch心率数据无法传输至iPhone

我来帮你一步步排查这个WatchConnectivity传输心率数据的问题——这种实时同步的坑我踩过不少，咱们从基础到细节捋一遍：

1. 先确认WatchConnectivity的基础配置是否到位 #

• 两边设备（Watch和iPhone）都必须正确初始化WCSession：
  • 在Watch Extension的ExtensionDelegate或你启动Workout的ViewController里，先判断WCSession.isSupported()，再调用WCSession.default.activate()，还要实现WCSessionDelegate的session(_:activationDidCompleteWith:error:)方法，确保会话激活成功（可以在回调里打印激活状态）。
  • iPhone端同理，在AppDelegate或对应ViewController做同样的初始化，而且必须设置delegate，否则根本收不到消息。
• 检查WCSession.default.isReachable状态：sendMessage只有在设备可达时才能正常工作（比如手表和手机蓝牙连接正常、iPhone端App至少在后台活跃）。调用sendMessage前可以打印这个状态，如果是false，那肯定发不出去——这时候要确认手机和手表连接正常，iPhone端App没被完全杀掉。

2. 给sendMessage加上错误处理器！ #

你说用了不带回复处理器的版本，但必须加上errorHandler，不然失败了也看不到任何报错信息，这是排查的关键！
比如把你的调用改成这样：

WCSession.default.sendMessage(["heartRate": currentHR], replyHandler: nil) { error in
    print("心率数据发送失败：\(error.localizedDescription)")
    print("错误详情：\(error)")
}

这样就能拿到具体的失败原因，比如会话未激活、设备不可达、数据格式不兼容等等。

3. 检查iPhone端的消息接收逻辑 #

• 确保iPhone端的WCSessionDelegate实现了session(_:didReceiveMessage:)方法，而且更新UI的操作要切到主线程：

  func session(_ session: WCSession, didReceiveMessage message: [String : Any]) {
      DispatchQueue.main.async {
          if let heartRate = message["heartRate"] as? Double {
              // 更新UI显示心率
              self.heartRateLabel.text = "\(heartRate) BPM"
          }
      }
  }
  

• 注意：如果iPhone端App被系统完全杀掉，didReceiveMessage不会触发。如果需要离线传输可以用transferUserInfo，但要实时显示的话，得保证iPhone端App至少在后台活跃。

4. 确认心率数据的获取和发送时机 #

• 你是在HKWorkoutSession的回调里获取心率数据吗？比如HKWorkoutSessionDelegate的workoutSession(_:didCollect:)方法？先打印拿到的心率值，确认是有效的（不是nil或异常值）。
• 发送频率别太高，每秒1次是合理的，如果几十毫秒就发一次，可能会被系统限流导致消息丢失。

5. 权限和项目配置检查 #

• 确保Watch Extension和iPhone App都开启了Watch Connectivity能力：在Xcode项目设置里，分别选中两个Target，在Signing & Capabilities里添加Watch Connectivity。
• 心率权限：Watch Extension必须请求HKObjectType.heartRate()的权限，且用户已经授权，不然根本拿不到心率数据，自然传不了。

6. 测试场景的注意事项 #

• 别用模拟器测试！模拟器的WatchConnectivity经常有莫名其妙的bug，一定要用真实设备。
• 确保iPhone和Watch的系统版本兼容，避免因版本差异导致的会话异常。

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