NSURL fileReferenceURL文件更新后失效？求有效解决方案

我之前也碰到过这个棘手的问题——fileReferenceURL在文件移动、重命名时表现很好，但一旦文件被替换（比如删除原文件后新建同名文件，或者用另一个文件覆盖替换），就会直接失效，因为它本质是绑定了文件的系统唯一inode标识，新文件属于完全不同的文件系统对象。

下面是几个经过验证的可行方案：

方案1：使用NSURL书签（Bookmark）（推荐） #

苹果官方其实更推荐用书签来持久化文件引用，它比fileReferenceURL灵活得多，会存储文件的多重标识信息（路径、inode、文件系统ID等），能应对移动、重命名甚至替换的场景。

代码示例 #

创建书签并持久化

func saveFileBookmark(for fileURL: URL) throws {
    // 创建书签数据，withSecurityScope用于沙盒外文件访问
    let bookmarkData = try fileURL.bookmarkData(
        options: .withSecurityScope,
        includingResourceValuesForKeys: nil,
        relativeTo: nil
    )
    // 把书签数据存在UserDefaults或者本地文件里
    UserDefaults.standard.set(bookmarkData, forKey: "SavedFileBookmark")
}

解析书签恢复文件引用

func restoreFileFromBookmark() throws -> URL? {
    guard let bookmarkData = UserDefaults.standard.data(forKey: "SavedFileBookmark") else {
        return nil
    }
    
    var isBookmarkStale = false
    let resolvedURL = try URL(
        resolvingBookmarkData: bookmarkData,
        options: .withSecurityScope,
        relativeTo: nil,
        bookmarkDataIsStale: &isBookmarkStale
    )
    
    // 如果书签过期（比如文件被多次修改或移动），重新生成并保存
    if isBookmarkStale {
        let newBookmarkData = try resolvedURL.bookmarkData(
            options: .withSecurityScope,
            includingResourceValuesForKeys: nil,
            relativeTo: nil
        )
        UserDefaults.standard.set(newBookmarkData, forKey: "SavedFileBookmark")
    }
    
    // 沙盒外文件需要开启权限访问
    if resolvedURL.startAccessingSecurityScopedResource() {
        defer { resolvedURL.stopAccessingSecurityScopedResource() }
        return resolvedURL
    }
    
    return resolvedURL
}

关键说明 #

• 书签会优先尝试用inode匹配文件，匹配不到时会 fallback 到路径查找，所以即使原文件被替换成同名新文件，也能正确解析到新文件。
• isBookmarkStale参数很重要，它会告诉我们书签是否已经过期，过期时重新生成书签可以保证后续引用的有效性。
• 针对沙盒外的文件，必须使用withSecurityScope选项，并在访问文件前后调用权限开关方法。

方案2：结合路径+文件属性（备选） #

如果场景比较简单，也可以存储文件的路径，同时记录文件的修改时间、文件大小等属性。每次访问时，先检查路径是否存在，再对比属性判断是否是目标文件（或者是否被更新）。

这种方式的缺点是可靠性不如书签，比如用户手动修改文件属性就会导致判断出错，但在一些简单场景下可以应急。

// 存储文件信息
func saveFileInfo(for fileURL: URL) throws {
    let attributes = try FileManager.default.attributesOfItem(atPath: fileURL.path)
    UserDefaults.standard.set(fileURL.path, forKey: "SavedFilePath")
    UserDefaults.standard.set(attributes[.modificationDate], forKey: "SavedFileModDate")
    UserDefaults.standard.set(attributes[.size], forKey: "SavedFileSize")
}

// 验证并获取文件
func getValidFileURL() -> URL? {
    guard let path = UserDefaults.standard.string(forKey: "SavedFilePath"),
          let savedModDate = UserDefaults.standard.object(forKey: "SavedFileModDate") as? Date,
          let savedSize = UserDefaults.standard.object(forKey: "SavedFileSize") as? Int64 else {
        return nil
    }
    
    let fileURL = URL(fileURLWithPath: path)
    guard let attributes = try? FileManager.default.attributesOfItem(atPath: path) else {
        return nil
    }
    
    let currentModDate = attributes[.modificationDate] as? Date
    let currentSize = attributes[.size] as? Int64
    
    if currentModDate == savedModDate && currentSize == savedSize {
        return fileURL
    } else {
        // 文件已更新，这里可以根据业务逻辑处理，比如提示用户或直接返回新文件
        return fileURL
    }
}

测试验证建议 #

在你的测试应用里可以这么验证：

1. 创建一个测试文件，用fileReferenceURL和书签分别保存引用。
2. 删除原文件，新建一个同名的新文件。
3. 尝试用fileReferenceURL访问，会发现无法找到文件。
4. 用书签解析，能正常获取到新文件的URL。

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