如何从视频URL生成缩略图？现有代码执行报错求助

嘿，我之前也碰到过这个烦人的错误！咱们来一步步拆解问题，找到解决办法：

常见原因及对应解决方案 #

1. 视频URL有效性问题 #

这个错误最常见的原因就是传入的URL有问题：

• 如果是本地文件URL，先确认文件真的存在，并且路径正确
• 如果是网络URL，要确保AVURLAsset能正确发起网络请求获取视频资源

可以在代码开头添加验证逻辑：

// 本地文件检查
if path.isFileURL {
    guard FileManager.default.fileExists(atPath: path.path) else {
        print("视频文件不存在或路径错误")
        return nil
    }
}

对于网络URL，给AVURLAsset添加网络相关配置，确保能正常加载：

let networkOptions = [
    AVURLAssetPreferPreciseDurationAndTimingKey: true,
    AVURLAssetHTTPHeaderFieldsKey: ["Accept": "video/*"]
]
let asset = AVURLAsset(url: path, options: networkOptions)

2. 起始帧无法获取 #

你用的CMTimeMake(0, 1)对应视频的第0秒帧，但有些视频的起始帧是空白的，或者编码时没有生成可获取的帧。建议换一个稍微靠后的时间点，比如视频的1秒处，或者视频时长的1/10位置：

// 优先取1秒处，视频过短则取中间位置
let thumbnailTime: CMTime
if asset.duration.seconds > 1 {
    thumbnailTime = CMTimeMakeWithSeconds(1, preferredTimescale: 600)
} else {
    thumbnailTime = CMTimeMultiplyByFloat64(asset.duration, multiplier: 0.5)
}

3. 视频轨道不可用 #

有些文件可能后缀是视频格式，但实际没有包含有效的视频轨道。可以先检查视频轨道是否存在：

guard !asset.tracks(withMediaType: .video).isEmpty else {
    print("该文件没有可用的视频轨道")
    return nil
}

4. 内存或配置问题 #

给AVAssetImageGenerator设置最大缩略图尺寸，避免生成过大的图片导致内存问题：

imgGenerator.maximumSize = CGSize(width: 320, height: 240) // 根据你的需求调整尺寸

修改后的完整代码 #

//MARK: - Generate Thumbnail
func getThumbnailFrom(path: URL) -> UIImage? {
    // 本地文件存在性检查
    if path.isFileURL {
        guard FileManager.default.fileExists(atPath: path.path) else {
            print("视频文件不存在或路径错误")
            return nil
        }
    }
    
    do {
        // 根据URL类型配置不同的选项
        let assetOptions: [String: Any]
        if path.isFileURL {
            assetOptions = [AVURLAssetPreferPreciseDurationAndTimingKey: true]
        } else {
            assetOptions = [
                AVURLAssetPreferPreciseDurationAndTimingKey: true,
                AVURLAssetHTTPHeaderFieldsKey: ["Accept": "video/*"]
            ]
        }
        
        let asset = AVURLAsset(url: path, options: assetOptions)
        
        // 检查是否有可用视频轨道
        guard !asset.tracks(withMediaType: .video).isEmpty else {
            print("该文件没有可用的视频轨道")
            return nil
        }
        
        let imgGenerator = AVAssetImageGenerator(asset: asset)
        imgGenerator.appliesPreferredTrackTransform = true
        // 设置缩略图最大尺寸，避免内存占用过高
        imgGenerator.maximumSize = CGSize(width: 320, height: 240)
        
        // 选择合适的缩略图时间点
        let thumbnailTime: CMTime
        if asset.duration.seconds > 1 {
            thumbnailTime = CMTimeMakeWithSeconds(1, preferredTimescale: 600)
        } else {
            thumbnailTime = CMTimeMultiplyByFloat64(asset.duration, multiplier: 0.5)
        }
        
        let cgImage = try imgGenerator.copyCGImage(at: thumbnailTime, actualTime: nil)
        let uiImage = UIImage(cgImage: cgImage)
        return uiImage
    } catch let error as NSError {
        // 打印完整错误信息，方便排查深层问题
        print("Error generating thumbnail: \(error.localizedDescription)")
        print("完整错误详情: \(error)")
        return nil
    }
}

额外排查技巧 #

遇到这类模糊的错误时，不要只打印localizedDescription，打印完整的error对象可以看到错误码和更多细节，比如错误码-11800对应的是无法完成操作，具体子错误码能帮你定位是文件损坏、权限不足还是网络问题。

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