Xcode16 SwiftUI异步获取视频缩略图QoS警告解决方法

警告原因 #

你的代码在用户交互级QoS线程（通常是主线程）中通过信号量semaphore.wait()阻塞，等待generateCGImageAsynchronously的回调执行。而该回调默认在默认QoS线程运行，导致高优先级线程等待低优先级线程，触发了优先级反转警告。

最优解决方案：用Async/Await重构 #

Swift 5.5+的async/await语法能彻底解决阻塞问题，同时适配SwiftUI的异步数据流模式，代码更简洁易维护：

重构后的异步函数 #

public func getVideoThumbnailImage(url: URL) async -> Image {
    let urlAsset = AVURLAsset(url: url)
    let assetImageGenerator = AVAssetImageGenerator(asset: urlAsset)
    assetImageGenerator.appliesPreferredTrackTransform = true
    assetImageGenerator.apertureMode = .encodedPixels
    
    let cmTime = CMTime(seconds: 1, preferredTimescale: 60)
    
    do {
        let cgImage = try await withCheckedThrowingContinuation { continuation in
            assetImageGenerator.generateCGImageAsynchronously(for: cmTime) { generatedImage, _, error in
                if let error = error {
                    continuation.resume(throwing: error)
                } else if let image = generatedImage {
                    continuation.resume(returning: image)
                } else {
                    continuation.resume(throwing: NSError(domain: "ThumbnailError", code: -1, userInfo: [NSLocalizedDescriptionKey: "生成缩略图失败"]))
                }
            }
        }
        return Image(uiImage: UIImage(cgImage: cgImage))
    } catch {
        return Image("ImageUnavailable")
    }
}

SwiftUI视图中调用方式 #

在视图中通过Task异步获取缩略图，避免阻塞UI线程：

struct VideoThumbnailView: View {
    let videoURL: URL
    @State private var thumbnail: Image?
    
    var body: some View {
        thumbnail ?? Image("ImageUnavailable")
            .onAppear {
                Task {
                    thumbnail = await getVideoThumbnailImage(url: videoURL)
                }
            }
    }
}

备选方案：指定回调队列QoS #

如果不想用async/await，可通过指定回调队列的QoS与调用线程匹配，消除优先级反转：

修改后的闭包版本代码 #

public func getVideoThumbnailImage(url: URL, completion: @escaping (Image) -> Void) {
    let urlAsset = AVURLAsset(url: url)
    let assetImageGenerator = AVAssetImageGenerator(asset: urlAsset)
    assetImageGenerator.appliesPreferredTrackTransform = true
    assetImageGenerator.apertureMode = .encodedPixels
    
    let cmTime = CMTime(seconds: 1, preferredTimescale: 60)
    
    // 指定回调在用户交互级QoS队列执行，匹配主线程优先级
    let callbackQueue = DispatchQueue.global(qos: .userInteractive)
    assetImageGenerator.generateCGImageAsynchronously(for: cmTime, queue: callbackQueue) { generatedImage, _, error in
        var resultImage = Image("ImageUnavailable")
        if error == nil, let cgImage = generatedImage {
            resultImage = Image(uiImage: UIImage(cgImage: cgImage))
        }
        // 回到主线程更新UI
        DispatchQueue.main.async {
            completion(resultImage)
        }
    }
}

视图中调用 #

.onAppear {
    getVideoThumbnailImage(url: videoURL) { image in
        thumbnail = image
    }
}

关键改进点 #

• 移除信号量阻塞：避免主线程被卡住，彻底解决优先级反转根源
• 匹配QoS级别：确保异步任务与调用线程的QoS一致，消除优先级不匹配问题
• 适配SwiftUI异步模式：用Task或回调更新UI，符合UI框架的最佳实践

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