iCloud中NSDocument保存警告是否由lastUsedDate文件属性引发？

这个问题我之前帮开发者排查过类似情况，核心原因是Binary Core Storage格式的Core Data文件在新版本系统中，打开时会自动写入一些元数据或修改文件属性（比如扩展属性、文件修改时间），而NSPersistentDocument和UIDocument的内置变更检测机制会把这些系统层面的变化当成“文件被其他应用修改”，从而弹出虚假警告。

可能的原因分析 #

• Binary Core Storage是比较老旧的存储格式，Apple在macOS 10.13和iOS 11中对Core Data的文件处理逻辑做了调整，打开文档时会自动更新一些隐藏的元数据（比如用于索引、缓存的扩展属性），这些操作会改变文件的修改时间或者文件属性，但并没有修改实际的Core Data数据。
• NSPersistentDocument/UIDocument默认会对比文件的修改时间、文件大小或者哈希值来判断文件是否被外部修改，当系统悄悄修改了这些属性时，就会触发警告。

具体解决方案 #

1. 优先考虑迁移到SQLite存储格式 #

Binary Core Storage已经被Apple标记为过时技术，SQLite格式不仅性能更好，而且在多设备/多应用访问时的文件状态管理更稳定，能从根源上避免这类元数据触发的虚假警告。

迁移步骤很简单：

• 在Core Data模型编辑器中，把存储类型从Binary改为SQLite；
• 确保你的NSPersistentDocument/UIDocument初始化时使用对应的持久化存储协调器配置；
• 测试现有数据的迁移（如果是已有用户，需要配置轻量迁移或者手动迁移逻辑）。

2. 自定义文档的变更检测逻辑 #

如果暂时无法迁移存储格式，可以重写文档类的状态检查方法，忽略系统产生的元数据变化：

对于macOS的NSPersistentDocument

重写checkAutosavingSafety方法，自定义文件变更的判断逻辑，比如只对比实际数据文件的内容哈希，而不是依赖系统的文件属性：

override func checkAutosavingSafety() throws {
    // 获取当前文件的实际数据哈希
    let currentFileHash = try calculateFileHash(for: self.fileURL!)
    // 获取打开文档时记录的初始哈希
    guard let initialHash = self.userInfo["initialFileHash"] as? String else {
        try super.checkAutosavingSafety()
        return
    }
    
    if currentFileHash == initialHash {
        // 文件实际内容未变，跳过系统的变更检测
        return
    } else {
        // 实际内容变更，执行默认检查
        try super.checkAutosavingSafety()
    }
}

// 在文档打开时记录初始哈希
override func read(from url: URL, ofType typeName: String) throws {
    try super.read(from: url, ofType: typeName)
    let initialHash = try calculateFileHash(for: url)
    self.userInfo["initialFileHash"] = initialHash
}

// 辅助方法：计算文件内容的哈希
private func calculateFileHash(for url: URL) throws -> String {
    let data = try Data(contentsOf: url)
    let hash = data.sha256() // 可基于CommonCrypto实现SHA256哈希计算
    return hash.map { String(format: "%02hhx", $0) }.joined()
}

对于iOS的UIDocument

重写hasUnsavedChanges和调整fileModificationDate的检查逻辑，或者在打开文档时记录文件的修改时间，保存前只对比实际数据变化：

private var initialFileModificationDate: Date?

override func open(completionHandler: ((Bool) -> Void)? = nil) {
    super.open { [weak self] success in
        if success {
            self?.initialFileModificationDate = try? self?.fileURL.resourceValues(forKeys: [.contentModificationDateKey]).contentModificationDate
        }
        completionHandler?(success)
    }
}

override var hasUnsavedChanges: Bool {
    // 先检查自己的内容是否真的有变更
    guard super.hasUnsavedChanges else {
        // 再检查文件修改时间是否真的被外部修改（排除系统元数据修改的小时间差）
        if let initialDate = initialFileModificationDate,
           let currentDate = try? fileURL.resourceValues(forKeys: [.contentModificationDateKey]).contentModificationDate {
            let timeInterval = currentDate.timeIntervalSince(initialDate)
            // 忽略1秒以内的时间变化（系统元数据修改通常很快）
            if timeInterval < 1 {
                return false
            }
        }
        return super.hasUnsavedChanges
    }
    return true
}

3. 检查并移除不必要的扩展属性 #

你可以用终端命令查看文件的扩展属性：

ls -l@ /path/to/your/document

如果发现Core Data自动添加了一些无关的扩展属性（比如com.apple.metadata:kMDItemUserTags或者其他Core Data缓存相关的属性），可以在打开文件后手动移除这些属性，避免触发变更检测：

try? url.removeResourceValue(forKey: .extendedAttributesKey)

不过这个方法需要谨慎，因为某些扩展属性可能是Core Data正常运行需要的。

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