iOS SwiftUI中bookmarkData保存Dropbox文件后无法获取更新内容的问题

问题根源 #

1. 云存储文件（如Dropbox）的本地缓存不会自动刷新，需主动触发系统同步最新版本
2. 书签解析后的isStale判断逻辑未正确处理，陈旧书签未重新生成
3. 读取文件时未通过安全范围资源访问的完整流程触发内容更新

具体修复方案 #

1. 修正陈旧书签的处理逻辑 #

当isStale为true时，不应直接丢弃URL，而是重新生成并保存新书签，确保后续访问指向最新资源：

func loadAllBookmarks() {
    guard let files = try? FileManager.default.contentsOfDirectory(at: getAppSandboxDirectory(), includingPropertiesForKeys: nil) else {
        self.urls = []
        return
    }
    
    self.urls = files.compactMap { file in
        do {
            let bookmarkData = try Data(contentsOf: file)
            var isStale = false
            let url = try URL(resolvingBookmarkData: bookmarkData, bookmarkDataIsStale: &isStale)
            
            // 处理陈旧书签：重新生成并保存
            if isStale {
                print("书签已过期，重新生成")
                guard url.startAccessingSecurityScopedResource() else {
                    return nil
                }
                defer { url.stopAccessingSecurityScopedResource() }
                
                let newBookmarkData = try url.bookmarkData(options: .minimalBookmark, includingResourceValuesForKeys: [.contentModificationDateKey], relativeTo: nil)
                try newBookmarkData.write(to: file)
            }
            
            return url
        } catch {
            print("加载书签失败：\(error)")
            return nil
        }
    }
}

2. 主动触发云文件同步与内容刷新 #

在读取文件内容前，通过NSFileCoordinator协调访问，确保获取最新版本的云文件。示例读取文件内容的方法：

func readLatestFileContent(from url: URL) -> String? {
    guard url.startAccessingSecurityScopedResource() else {
        return nil
    }
    defer { url.stopAccessingSecurityScopedResource() }
    
    let fileCoordinator = NSFileCoordinator()
    var content: String?
    var error: NSError?
    
    fileCoordinator.coordinate(readingItemAt: url, options: .withoutChanges, error: &error) { (newURL) in
        do {
            content = try String(contentsOf: newURL, encoding: .utf8)
        } catch let readError {
            print("读取文件失败：\(readError)")
        }
    }
    
    if let error = error {
        print("文件协调失败：\(error)")
    }
    
    return content
}

3. 监听文件变化通知 #

注册NSMetadataQuery监听云文件的变化，当文件内容更新时自动触发刷新：

private var metadataQuery: NSMetadataQuery?

func setupFileChangeObserver() {
    metadataQuery = NSMetadataQuery()
    metadataQuery?.predicate = NSMetadataQuery.predicate(forItemsWithURLs: urls)
    metadataQuery?.searchScopes = [NSMetadataQueryUbiquitousDocumentsScope]
    
    NotificationCenter.default.addObserver(self, selector: #selector(handleFilesChanged(_:)), name: .NSMetadataQueryDidFinishGathering, object: metadataQuery)
    NotificationCenter.default.addObserver(self, selector: #selector(handleFilesChanged(_:)), name: .NSMetadataQueryDidUpdate, object: metadataQuery)
    
    metadataQuery?.start()
}

@objc private func handleFilesChanged(_ notification: Notification) {
    guard let query = notification.object as? NSMetadataQuery else { return }
    query.disableUpdates()
    
    // 这里重新加载书签并刷新文件内容
    loadAllBookmarks()
    refreshFileContentDisplay()
    
    query.enableUpdates()
}

关键注意事项 #

• 必须始终成对调用startAccessingSecurityScopedResource()和stopAccessingSecurityScopedResource()，确保安全范围资源的正确释放
• NSFileCoordinator是处理云存储文件访问的标准方式，能自动协调本地缓存与云端内容的同步
• 监听文件变化需在合适的生命周期（如viewDidLoad）启动，在销毁时移除通知并停止查询

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