CloudKit Query Subscription订阅成功后推送通知无法触发问题求助

可行排查解决步骤 #

1. 检查CloudKit RecordType索引配置
   登录CloudKit控制台，定位到Post这个记录类型，检查索引配置：

   • 确认Plate字段已设置为Queryable（可查询）索引
   • 确认createdAt、modifiedAt字段已设置为Sortable（可排序）索引
     这是订阅随机失效的最常见原因：测试初期数据量小时无索引也能触发推送，数据量上升后CloudKit后台会强制拦截无索引的查询请求，订阅即使创建成功也不会触发通知。

2. 修复重复订阅的问题
   你当前的代码没有指定固定的订阅ID，每次用户点击按钮都会生成一个随机ID的新订阅，CloudKit对同一用户同一查询条件的订阅上限为3个，超出后会被后台静默随机删除，你在后台看到的订阅可能是刚创建的临时数据，被删除后自然收不到推送。
   优化方案：创建CKQuerySubscription时指定固定的ID，比如用"PlateSubscribe_" + self.selectedPlate!作为订阅ID，每次创建前先查询同ID的订阅是否已存在，存在则跳过重复创建。

3. 修复通知参数冲突问题
   你同时配置了shouldSendContentAvailable = true（静默推送标识）和普通通知的alertBody、title参数，iOS 16+系统会判定参数冲突，随机拦截这类推送。二选一修改即可：

   • 如果不需要后台静默唤醒，直接把shouldSendContentAvailable设为false
   • 如果需要静默推送，单独创建不带alert配置的订阅，和普通通知订阅分开处理
     另外你当前didReceiveRemoteNotification方法直接返回.noData，如果系统多次判定你处理静默推送无实际逻辑，会暂时停止向你的应用推送CloudKit通知，一段时间后才恢复，看起来就是随机失效的现象。

4. 修改角标清空逻辑
   你在didFinishLaunchingWithOptions启动方法里直接把applicationIconBadgeNumber设为0，这个操作会同时清空通知中心所有你的应用的推送通知，就会出现通知弹出后立刻消失、角标同步消失的现象。把这行代码移到你需要主动清空角标的业务逻辑位置（比如用户进入消息列表页时），不要放在启动方法里执行。

5. 检查推送证书匹配情况
   登录Apple Developer后台，确认你的App ID对应的推送证书未过期，同时注意：

   • 本地Xcode调试时CloudKit走开发环境，对应开发环境推送证书
   • TestFlight、App Store包走生产环境，对应生产环境推送证书
     环境和证书不匹配的情况下，订阅创建成功也不会收到推送。

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