iOS 17重启应用时UserDefaults被清空问题求助

iOS 16 → iOS 17 相关机制变化 #

• 存储路径与权限收紧：iOS17调整了应用容器内文件的权限校验逻辑，上线10年+的老项目可能保留了早期iOS版本创建的UserDefaults plist文件，其权限配置不符合iOS17的新要求，导致系统启动时无法读取旧数据，直接初始化空存储。
• App Groups 元数据兼容性：iOS17优化了App Groups的沙箱隔离机制，跨多个iOS版本迭代的App Group容器，可能因元数据格式老旧触发系统的数据重置逻辑，新项目因为是全新容器则不受影响。
• 默认数据保护等级提升：即便未开启Data Protection Entitlement，iOS17也提高了应用数据的默认保护等级。老项目若依赖早期较低保护等级存储UserDefaults，iOS17下会无法访问旧数据，进而重建空存储文件。

无需全量迁移Keychain的解决方案 #

1. 手动迁移旧UserDefaults数据 #

启动时主动检查旧路径下的plist文件，读取后写入当前有效UserDefaults，避免全量迁Keychain：

// 迁移standard UserDefaults示例
let oldPlistPath = NSSearchPathForDirectoriesInDomains(.libraryDirectory, .userDomainMask, true)[0] 
    + "/Preferences/你的AppBundleID.plist"

if FileManager.default.fileExists(atPath: oldPlistPath) {
    guard let oldData = FileManager.default.contents(atPath: oldPlistPath),
          let oldDataDict = try? PropertyListSerialization.propertyList(from: oldData, format: nil) as? [String: Any] else {
        return
    }
    
    let standardDefaults = UserDefaults.standard
    oldDataDict.forEach { key, value in
        standardDefaults.set(value, forKey: key)
    }
    standardDefaults.synchronize()
    
    // 删除旧文件防止重复迁移
    try? FileManager.default.removeItem(atPath: oldPlistPath)
}

// App Group版本迁移示例
if let groupContainerURL = FileManager.default.containerURL(forSecurityApplicationGroupIdentifier: "group.com.aaa") {
    let oldGroupPlistPath = groupContainerURL.appendingPathComponent("Library/Preferences/group.com.aaa.plist").path
    if FileManager.default.fileExists(atPath: oldGroupPlistPath) {
        // 同上面的读取、写入、删除逻辑
    }
}

2. 修复App Group容器权限 #

针对App Group的情况，启动时修复容器目录权限，确保系统能正常读取存储文件：

if let groupContainerURL = FileManager.default.containerURL(forSecurityApplicationGroupIdentifier: "group.com.aaa") {
    let preferencesDirURL = groupContainerURL.appendingPathComponent("Library/Preferences")
    do {
        try FileManager.default.setAttributes([.posixPermissions: 0o755], ofItemAtPath: preferencesDirURL.path)
    } catch {
        print("权限修复失败: \(error.localizedDescription)")
    }
}

3. 调整UserDefaults同步逻辑 #

老项目若依赖synchronize()的旧用法，iOS17下需确保关键数据写入后立即调用该方法，或通过监听UserDefaults.didChangeNotification保障数据持久化：

// 写入数据后同步
UserDefaults.standard.set("示例数据", forKey: "testKey")
UserDefaults.standard.synchronize()

// 监听变化确保持久化
NotificationCenter.default.addObserver(forName: UserDefaults.didChangeNotification, object: nil, queue: .main) { _ in
    UserDefaults.standard.synchronize()
}

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