WidgetPushHandler方法未调用，无法获取Watch Widget推送令牌

针对你遇到的Watch Widget无法获取推送令牌、pushTokenDidChange方法未调用的问题，整理以下实用排查步骤：

• 检查Widget扩展的推送配置完整性

  1. 打开Widget扩展的Info.plist，确认添加了NSExtension -> NSExtensionAttributes -> WKWidgetConfiguration，并新增SupportsPushNotifications键，设置值为YES。这是Widget接收推送令牌的必要配置，容易被忽略。
  2. 确认Widget扩展的Target已单独添加Push Notifications能力：在Xcode中选中Widget扩展目标，进入Signing & Capabilities页面，确认该能力已添加，且对应的Provisioning Profile包含推送权限。

• 验证Widget的激活状态

  1. 确保Widget处于当前显示的表盘页面，且完全可见（没有被其他元素遮挡）。系统仅会向当前激活的Widget推送令牌。
  2. 尝试重启Apple Watch，清除系统推送令牌缓存后，可能触发令牌刷新逻辑。
  3. 手动调整Widget大小（比如在Watch App中切换小/中/大尺寸），切换回表盘后，系统可能重新请求推送令牌。

• 核对代码实现细节

  1. 确认pushHandler已正确绑定到Widget配置中，示例代码如下：

     struct WatchAppWidget: Widget {
         let kind: String = "WatchAppWidget"
     
         var body: some WidgetConfiguration {
             StaticConfiguration(kind: kind, provider: Provider()) { entry in
                 WatchAppWidgetEntryView(entry: entry)
             }
             .configurationDisplayName("My Widget")
             .description("This is an example widget.")
             .pushHandler(WatchAppWidgetPushHandler.self) // 此处需正确添加
         }
     }
     

  2. 确保WatchAppWidgetPushHandler的访问权限正确：如果该结构体不在Widget的主文件中，需添加public或internal修饰符，避免系统无法调用其方法。

• 系统与环境验证

  1. 你使用的WatchOS 26.1是测试版系统，可能存在功能不稳定的问题，建议升级至最新正式版或测试版后重试。
  2. 确认iPhone与Apple Watch配对正常，且登录同一Apple ID；同时检查Watch的设置->通知中，Widget推送相关权限已开启。

• 调试与日志排查

  1. 将Apple Watch连接到Xcode，选择Widget扩展作为调试目标，查看控制台日志，系统可能会输出推送配置错误、令牌请求失败等相关提示。
  2. 在Widget的getTimeline方法中添加日志，确认Widget扩展确实处于运行状态，排除扩展未激活的问题。

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