WatchKit无法读取共享UserDefaults值？已配置App Group仍异常

以下是针对该问题的排查和解决步骤：

• 确认App Group配置完全一致
  检查iOS主应用和WatchKit Extension（注意是运行代码的Extension目标，而非Watch App壳目标）的Capabilities面板，确保两者都开启了App Groups，且勾选了完全相同的Group ID（比如group.com.my.app），大小写、拼写不能有任何差异。同时登录苹果开发者后台，确认该Group ID已在账号中创建，且两个目标的Bundle ID都关联了该Group。

• 验证iOS端的写入逻辑
  确保iOS端将值写入到共享的App Group容器中，而非默认的UserDefaults.standard。正确的写入代码示例：

  let sharedDefaults = UserDefaults(suiteName: "group.com.my.app")
  sharedDefaults?.set(true, forKey: "dark_mode")
  sharedDefaults?.synchronize() // 调试阶段可添加，确保立即同步
  

  若使用UserDefaults.standard写入，Watch端将无法读取到对应值。

• 检查Watch端的读取逻辑
  Watch端读取时，必须同样获取共享容器的UserDefaults实例，而非默认实例。另外，bool(forKey:)在键不存在时会返回默认的false，需确认iOS端已成功写入true值。可通过读取字符串类型的测试键验证连通性：

  let sharedDefaults = UserDefaults(suiteName: "group.com.my.app")
  let testValue = sharedDefaults?.string(forKey: "test_key")
  print(testValue) // 先在iOS端写入该键，观察Watch端是否能获取到
  

• 调试环境清理与验证

  • 确保iOS模拟器和Watch模拟器处于配对状态（真机调试需保证手机与手表配对且使用同一开发者账号签名）。
  • 执行Command+Shift+K清理项目缓存，删除模拟器/真机上的iOS和Watch应用后重新编译安装，旧缓存可能导致App Group配置不生效。
  • 确认WatchKit Extension的Capabilities中App Groups已正确开启，新增Watch目标后Xcode有时不会自动配置，需手动开启并勾选对应Group。

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