iCloud Drive存储满数据风险判断及存储空间查询方法

当iCloud存储空间已满时，已存储的数据会出现什么情况？ #

已经成功完成云端上传、持久化在iCloud服务器上的已有数据不会被系统自动删除，会一直保留，直到用户手动删除iCloud内对应文件、卸载应用、或主动注销对应Apple ID。
此时iCloud的跨设备同步链路会自动暂停：后续新写入ubiquity容器的文件只会暂存在当前设备的本地缓存中，既不会上传到iCloud云端，也不会推送到同账号下的其他设备。

如何检测判断用户的iCloud存储空间是否已满？ #

推荐两种可落地的检测方案，优先用第一种的结果作为判断依据：

• 错误回调捕获：在文件上传流程中，通过NSMetadataQuery或者NSFileManager的资源值查询方法，获取iCloud容器内文件的NSURLUbiquitousItemUploadingErrorKey属性，如果返回的错误属于NSCocoaErrorDomain、错误码为NSFileWriteOutOfSpaceError（码值640），即可判定当前iCloud云端剩余空间不足，无法完成文件上传。
• 辅助预判：在应用启动、切前后台的时机，调用NSFileManager的attributesOfFileSystemForPath:error:方法，传入本地iCloud容器路径，查询当前iCloud本地缓存目录的可用空间，结合待上传文件的总大小做提前预警，注意这个值仅代表本地缓存配额，不是云端实际剩余空间，不能作为空间不足的最终判断依据。

iCloud存储已满状态下持续写入数据，是否存在iCloud端文件被删除的风险？ #

你测试时观察到的“仍可继续上传”是本地缓存写入的正常表现，本质上这部分新文件根本没有成功上传到iCloud云端。
首先明确规则：已经成功上传到iCloud云端的文件，系统不会因为空间不足自动删除，不存在云端存量文件被系统清理的风险。但暂存在本地、未完成云端上传的新写入文件，存在明确的丢失风险：

• 如果用户在文件未上传完成时卸载应用，本地iCloud容器缓存会被系统直接清空，这部分未上传的文件会彻底丢失。
• 如果用户在其他登录同账号的设备上删除了iCloud内同路径的旧文件，同步指令下发到当前设备时，本地未上传的新文件可能被旧的删除操作覆盖，导致数据丢失。
• iOS/macOS的iCloud本地缓存有自动回收机制，如果设备本身本地存储空间不足，系统会优先清理长期未上传成功、且未标记为“始终保留本地副本”的iCloud缓存文件，这部分未上传数据会被直接清除。

针对你存储文本+图片编码JSON的场景，建议做两层防护避免数据丢失：

• 所有写入iCloud容器的文件，同步在应用沙盒的非iCloud同步目录保留一份本地备份，直到检测到文件的NSURLUbiquitousItemIsUploadedKey属性返回YES（即确认已成功上传到云端）之后，再按需清理本地备份。
• 捕获到iCloud空间不足错误时，在应用内给出明确提示，告知用户当前iCloud空间已满，新数据暂时无法同步到云端，引导用户清理iCloud空间或手动导出本地备份，避免用户误以为数据已完成多端同步造成损失。

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