为何通过FileManager获取的URL无法在AVPlayer中正常工作？

这种情况我之前调试时也踩过坑！核心问题其实出在macOS沙箱的权限机制上——虽然两个URL用==比较完全相同，但NSOpenPanel会自动为你申请该文件的访问权限并添加到安全范围，而直接通过FileManager遍历拿到的URL，默认没有对应的权限授权，AVPlayer在沙箱限制下会静默失败，甚至不会抛出明显错误。

下面是具体的排查和解决步骤：

1. 用NSFileCoordinator处理权限访问 #

直接用FileManager拿到的URL可能存在权限限制，NSFileCoordinator会帮你处理沙箱下的文件访问逻辑，确保AVPlayer能拿到合法的访问路径：

let targetURL = // 你通过FileManager获取的视频文件URL
let coordinator = NSFileCoordinator()
coordinator.coordinate(readingItemAt: targetURL, options: .withoutChanges, error: nil) { safeURL in
    let playerItem = AVPlayerItem(url: safeURL)
    yourPlayer.replaceCurrentItem(with: playerItem)
}

2. 持久化目录访问权限 #

如果你的视频文件都在同一个目录下，最好让用户先通过NSOpenPanel选择一次目录，把该目录的访问权限持久化下来，这样后续遍历目录内的文件都能正常访问：

第一步：获取并存储目录权限书签 #

let openPanel = NSOpenPanel()
openPanel.canChooseDirectories = true
openPanel.allowsMultipleSelection = false
if openPanel.runModal() == .OK {
    guard let dirURL = openPanel.url else { return }
    // 生成带安全范围的书签数据
    if let bookmarkData = try? dirURL.bookmarkData(options: .withSecurityScope, includingResourceValuesForKeys: nil, relativeTo: nil) {
        // 把书签存到UserDefaults，下次启动可恢复
        UserDefaults.standard.set(bookmarkData, forKey: "VideoDirectoryBookmark")
    }
}

第二步：启动时恢复权限并启用安全访问 #

if let bookmarkData = UserDefaults.standard.data(forKey: "VideoDirectoryBookmark") {
    var isStale = false
    do {
        let dirURL = try URL(resolvingBookmarkData: bookmarkData, options: .withSecurityScope, relativeTo: nil, bookmarkDataIsStale: &isStale)
        if isStale {
            // 书签失效时重新生成并存储
            let newBookmark = try dirURL.bookmarkData(options: .withSecurityScope, includingResourceValuesForKeys: nil, relativeTo: nil)
            UserDefaults.standard.set(newBookmark, forKey: "VideoDirectoryBookmark")
        }
        // 启用安全范围访问
        if dirURL.startAccessingSecurityScopedResource() {
            // 这里就可以正常用FileManager遍历目录下的视频文件了
        }
    } catch {
        print("恢复目录权限失败：\(error)")
    }
}

3. 监听AVPlayerItem的隐藏错误 #

虽然你说没有错误输出，但可以给AVPlayerItem添加错误监听，获取更详细的失败信息：

let playerItem = AVPlayerItem(url: yourURL)
playerItem.addObserver(self, forKeyPath: "error", options: .new, context: nil)

// 在观察者方法中处理错误
override func observeValue(forKeyPath keyPath: String?, of object: Any?, change: [NSKeyValueChangeKey : Any]?, context: UnsafeMutableRawPointer?) {
    guard keyPath == "error", let item = object as? AVPlayerItem, let error = item.error else {
        super.observeValue(forKeyPath: keyPath, of: object, change: change, context: context)
        return
    }
    print("AVPlayer加载失败：\(error.localizedDescription)")
}

4. 验证URL的安全访问状态 #

可以打印url.startAccessingSecurityScopedResource()的返回值，如果返回false，说明当前URL没有权限，需要回到前面的步骤处理权限问题。

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