使用DVAssetLoaderDelegate缓存后AVAsset无法加载本地视频文件问题

我之前也碰到过类似的情况，结合你用DVAssetLoaderDelegate做视频缓存的场景，咱们一步步排查问题：

1. 先确认本地文件URL的格式是否正确 #

AVAsset必须使用file://开头的URL才能正确加载本地文件，如果你直接用纯字符串路径（比如/Users/xxx/Library/Caches/xxx.mp4）初始化，大概率会失败。你可以用这段代码把文件路径转成标准URL：

let cacheDir = NSSearchPathForDirectoriesInDomains(.cachesDirectory, .userDomainMask, true)[0]
let filePath = cacheDir.appending("/your_video_filename.mp4")
guard let fileURL = URL(fileURLWithPath: filePath) else {
    print("无效的本地文件路径")
    return
}
// 用这个fileURL初始化AVAsset
let asset = AVAsset(url: fileURL)

2. 检查文件权限与完整性 #

虽然你在模拟器里看到文件存在，但有可能写入时权限不对，或者文件本身不完整（比如下载中断只写入了部分数据）：

• 打印文件属性确认大小是否符合预期：

do {
    let attributes = try FileManager.default.attributesOfItem(atPath: filePath)
    if let fileSize = attributes[.size] as? Int64 {
        print("文件大小：\(fileSize) bytes")
    }
} catch {
    print("获取文件属性失败：\(error)")
}

• 写入文件时建议用atomic选项，保证写入的完整性：

// 写入缓存文件的正确示例
let videoData = // 下载得到的视频数据
do {
    try videoData.write(to: fileURL, options: .atomic)
} catch {
    print("写入缓存失败：\(error)")
}

3. 不要忽略AVAsset的加载状态检查 #

AVAsset初始化后不会立刻加载资源，你需要异步加载关键属性（比如tracks）来确认是否能正常使用：

let asset = AVAsset(url: fileURL)
asset.loadValuesAsynchronously(forKeys: ["tracks"]) {
    var error: NSError?
    let status = asset.statusOfValue(forKey: "tracks", error: &error)
    DispatchQueue.main.async {
        switch status {
        case .loaded:
            // 资源加载成功，可以创建AVPlayerItem
            let playerItem = AVPlayerItem(asset: asset)
        case .failed:
            print("AVAsset加载失败：\(error?.localizedDescription ?? "未知错误")")
        case .cancelled:
            print("加载被取消")
        default:
            break
        }
    }
}

这里的错误信息会帮你定位核心问题，比如文件格式不支持、文件损坏等。

4. 结合DVAssetLoaderDelegate的特殊情况 #

如果你的视频是HLS（.m3u8）格式，DVAssetLoaderDelegate缓存的可能是分片文件和索引文件，这时候不能直接用本地分片文件初始化AVAsset，而是要继续使用原来的远程URL，让DVAssetLoaderDelegate内部自动读取本地缓存的分片资源。

另外，确认你初始化AVAsset时，已经正确配置了URLSession与DVAssetLoaderDelegate的关联，确保缓存文件能被组件正确识别。

内容的提问来源于stack exchange，提问作者Can Poyrazoğlu