iOS端getApplicationDocumentsDirectory目录文件更新后丢失是什么原因？

iOS沙盒Documents目录文件丢失的常见场景 #

• 用户手动执行「删除App」操作：卸载时系统会清空对应应用的整个沙盒目录，Documents目录内所有文件会被一并删除。注意如果是「卸载未使用的App」（Offload App），Documents目录内容会保留，下次重装应用时自动恢复，不会丢失。
• 应用更新过程中出现异常：系统存储空间不足、更新过程中强制中断等极端情况，会导致沙盒文件迁移失败，文件丢失。
• 应用代码主动删除文件：如果新版本新增了缓存清理逻辑，误判Documents内的用户文件为冗余数据执行删除，也会导致文件消失。
• 开启iCloud Documents同步后冲突：如果应用开启了iCloud Documents能力，云端同步逻辑出现异常时，可能会覆盖或删除本地文件。

对应三个操作的影响说明 #

• 未修改BundleID：只要BundleID未发生变更，正常更新场景下iOS会自动将旧沙盒内的Documents目录内容迁移到新的GUID沙盒路径下，getApplicationDocumentsDirectory() 接口会自动返回当前沙盒的正确路径，该操作不会导致文件丢失。
• 最低支持版本调整到iOS 10.0：iOS沙盒访问规则从iOS 8之后没有发生过变更，提升最低支持版本的操作本身不会触发Documents目录内容清空，也不会影响文件迁移逻辑。
• 签名方式变更：该操作是最可能的问题根源。iOS系统判断应用是否为同一款更新包的依据是「BundleID + 签名 Team ID」的组合，哪怕BundleID完全一致，如果签名使用的团队ID、证书类型发生了变更（比如个人开发者签名更换为企业团队签名、测试证书更换为发布证书、Bundle Seed ID变更等），系统会将新版应用识别为完全独立的新应用，更新时不会执行沙盒文件迁移，自然无法读取到旧版存储的文件。

排查建议 #

• 可以执行 codesign -dvvv 旧版IPA路径 和 codesign -dvvv 新版IPA路径 对比输出的TeamIdentifier字段是否一致，确认签名身份是否发生变化。
• 可通过Xcode的「Window -> Devices and Simulators」功能，下载覆盖安装新版后的应用沙盒内容，直接查看Documents目录下是否存在旧的json文件，确认是文件丢失还是读取逻辑问题。
• 检查新版代码是否新增了Documents目录的清理逻辑，确认读取目录的时机是否在getApplicationDocumentsDirectory异步返回之后，排除逻辑错误导致的读取结果为空。

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