共享CloudKit数据库变更通知无法接收问题求助

针对你遇到的共享CloudKit数据库变更通知收不到的问题，结合你的代码和配置，给出以下关键修复和排查方向：

1. 补全推送令牌注册逻辑 #

你的代码仅调用了application.registerForRemoteNotifications()，但缺少令牌注册的回调逻辑，这会导致CloudKit无法将通知推送到设备。必须添加以下方法：

func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
    let tokenParts = deviceToken.map { data in String(format: "%02.2hhx", data) }
    let token = tokenParts.joined()
    print("Device Token: \(token)")
    // CloudKit会自动关联该令牌到订阅，无需手动处理，但需确保此方法正常执行
}

func application(_ application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: Error) {
    print("推送令牌注册失败: \(error.localizedDescription)")
}

如果上述方法未触发，说明未获取到推送权限，需先请求用户授权：

// 在application:didFinishLaunchingWithOptions:或合适时机添加
import UserNotifications

UNUserNotificationCenter.current().requestAuthorization(options: [.badge]) { granted, error in
    if granted {
        DispatchQueue.main.async {
            UIApplication.shared.registerForRemoteNotifications()
        }
    }
}

注意：即使是静默通知（shouldSendContentAvailable = true），也需要请求至少一种权限（如.badge），否则系统会拒绝推送。

2. 确认RecordType的正确值 #

subscription.recordType必须使用CloudKit控制台中显示的记录类型名称——CoreData与CloudKit同步时，默认会给实体名添加CD_前缀，因此正确值应为CD_Todo。你可以登录iCloud控制台，进入对应容器的Schema页面确认准确名称。

3. 优化订阅创建逻辑 #

你当前在configurationForConnecting中创建订阅，该方法可能被多次调用导致重复创建。建议先检查订阅是否已存在，避免重复操作：

func createSharedDBSubscription() {
    let subscriptionID = "todoChanges"
    let fetchOp = CKFetchSubscriptionsOperation(subscriptionIDs: [subscriptionID])
    
    fetchOp.fetchSubscriptionCompletionBlock = { subscriptions, error in
        if let error = error {
            print("获取订阅失败: \(error)")
            return
        }
        
        if subscriptions?.keys.contains(subscriptionID) == true {
            // 订阅已存在，无需重复创建
            return
        }
        
        // 创建新订阅
        let subscription = CKDatabaseSubscription(subscriptionID: subscriptionID)
        subscription.recordType = "CD_Todo"
        
        let notificationInfo = CKSubscription.NotificationInfo()
        notificationInfo.shouldSendContentAvailable = true
        notificationInfo.shouldBadge = false // 静默通知无需角标
        
        subscription.notificationInfo = notificationInfo
        
        let modifyOp = CKModifySubscriptionsOperation(subscriptionsToSave: [subscription], subscriptionIDsToDelete: nil)
        modifyOp.modifySubscriptionsCompletionBlock = { _, _, error in
            if let error = error {
                print("保存订阅失败: \(error)")
            } else {
                print("共享数据库订阅创建成功")
            }
        }
        
        CKContainer.default().sharedCloudDatabase.add(modifyOp)
    }
    
    CKContainer.default().sharedCloudDatabase.add(fetchOp)
}

随后在application:didFinishLaunchingWithOptions:或configurationForConnecting中调用此方法即可。

4. 处理iOS 10+的前台通知接收 #

iOS 10及以上版本中，前台收到通知不会触发application:didReceiveRemoteNotification:fetchCompletionHandler:，需通过UNUserNotificationCenterDelegate处理：

// 在AppDelegate中添加UNUserNotificationCenterDelegate协议
class AppDelegate: NSObject, UIApplicationDelegate, UNUserNotificationCenterDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        UNUserNotificationCenter.current().delegate = self
        // 其他初始化逻辑
        return true
    }
    
    // 处理前台收到的通知
    func userNotificationCenter(_ center: UNUserNotificationCenter, willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
        let userInfo = notification.request.content.userInfo
        if let ckNotification = CKNotification(fromRemoteNotificationDictionary: userInfo), ckNotification.notificationType == .database {
            print("共享数据库发生变更(前台)")
            // 此处可触发数据拉取逻辑
        }
        // 静默通知无需显示，传空即可
        completionHandler([])
    }
    
    // 处理后台/点击通知的情况
    func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
        let userInfo = response.notification.request.content.userInfo
        if let ckNotification = CKNotification(fromRemoteNotificationDictionary: userInfo), ckNotification.notificationType == .database {
            print("共享数据库发生变更(后台/点击)")
        }
        completionHandler()
    }
}

这样无论应用处于前台还是后台，都能捕获到CloudKit的变更通知。

5. 排查测试环节问题 #

• 确保在iCloud控制台修改的是共享数据库的记录，而非私有数据库；
• 通知存在延迟，修改记录后等待1-2分钟再查看日志；
• 检查CloudKit环境匹配：Debug模式应用对应控制台的开发环境，Release模式对应生产环境，环境不匹配不会触发通知。

6. 验证后台模式配置 #

确认Xcode的Signing & Capabilities中，Background Modes已勾选Remote notifications——此配置正确，无需额外勾选Background fetch。

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