Thanks for being a part of WWDC25!

How did we do? We’d love to know your thoughts on this year’s conference. Take the survey here

NSPersistentCloudKitContainer causes crash on watchOS when device is offline

Hi. I'm hoping someone might be able to help us with an issue that's been affecting our standalone watchOS app for some time now.

We've encountered consistent crashes on Apple Watch devices when the app enters the background while the device is offline (i.e., no Bluetooth and no Wi-Fi connection). Through extensive testing, we've isolated the problem to the use of NSPersistentCloudKitContainer. When we switch to NSPersistentContainer, the crashes no longer occur.

Interestingly, this issue only affects our watchOS app. The same CloudKit-based persistence setup works reliably on our iOS and macOS apps, even when offline. This leads us to believe the issue may be specific to how NSPersistentCloudKitContainer behaves on watchOS when the device is disconnected from the network.

We're targeting watchOS 10 and above. We're unsure if this is a misconfiguration on our end or a potential system-level issue, and we would greatly appreciate any insight or guidance.

Can you share the crash log? Or file a feedback report with it attached and a sysdiagnose from the affected device?

TN3163: Understanding the synchronization of NSPersistentCloudKitContainer | Apple Developer Documentation

NSPersistentCloudKitContainer causes crash on watchOS when device is offline
 
 
Q