iOS模拟器中FileManager每次启动生成不同URL致数据持久化失败

• 代码API误用：你使用appendingPathExtension拼接存储路径，这个API的作用是为路径追加文件后缀，并非追加文件/目录名组件，会导致路径生成不符合预期。
• 沙盒机制认知偏差：iOS应用沙盒Application目录下的UUID不是固定值，模拟器在App重装、Xcode重启、模拟器重置时，真机在App重装、系统版本升级时，这串UUID都会发生变化，属于系统正常行为，不需要调整电脑任何设置。绝对不要持久化存储沙盒文件的完整绝对路径，这类路径随时可能失效。

修正路径生成代码 #

将路径拼接API替换为appendingPathComponent，且每次读写文件前都动态获取最新的沙盒目录路径，不要缓存旧的完整URL：

public extension FileManager {
    func persistentStorageURL(hash: String, isDirectory: Bool = false) throws -> URL {
        // 每次调用实时获取最新的Documents目录路径
        let documentsDir = try url(
            for: .documentDirectory,
            in: .userDomainMask,
            appropriateFor: nil,
            create: true
        )
        // 正确拼接路径组件，根据实际类型标记是否为目录
        return documentsDir.appendingPathComponent(hash, isDirectory: isDirectory)
    }
}

调用规则 #

// 仅需要持久化你自定义的文件名/相对路径标识即可，不要存完整absoluteString
let fileIdentifyKey = deterministicHash + "downloadData"
// 每次读写前动态获取最新可用URL
let localURL = try! FileManager.default.persistentStorageURL(hash: fileIdentifyKey)

不同存储场景的目录选择 #

• 需要用户可见、长期留存、会被iTunes/iCloud备份的文件（比如用户手动保存的图片、导出的文档）：使用.documentDirectory
• 可被系统自动清理的临时缓存（比如网络下载的临时图片、可重复下载的资源）：使用.cachesDirectory
• 应用内部使用、不需要对用户展示的持久化大文件：使用.applicationSupportDirectory，注意调用时传入create: true，该目录默认不会自动创建

• 重新build安装App到模拟器时，沙盒会被完全重建，旧文件会被清空，UUID必然变化，属于正常开发流程现象，不是代码问题。
• 不重装App仅冷启动时，即使沙盒UUID变化，系统会自动将旧沙盒内的文件迁移到新路径下，只要你每次动态获取最新路径，就可以正常读取之前存储的文件。
• 存储大量图片时建议按业务划分二级子目录，避免所有文件堆在根目录降低文件访问效率。

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