如何将Vision框架多请求的Completion Handler转为异步实现？

我正在使用Apple的Vision框架对单张图片执行多项检测请求。VNImageRequestHandler.perform()会调度多个请求（通常在单独线程中），每个请求都定义了Completion Handler，最终结果需赋值给类变量。

我了解Continuation是将基于Completion Handler的API转为异步代码的最佳方式，但Continuation只能恢复一次。AsyncStream似乎是更可行的方案，但结果可能无序返回，且我的请求数量是固定的。

请问针对以下代码，最符合Swift风格的异步范式是什么？

// non-async code
let handler = VNImageRequestHandler(url: url)
let faceQualityRequest = VNDetectFaceCaptureQualityRequest { request, err in
    guard err == nil else { return }
    self.faceDetectionResults = request.results
}
let featurePrintRequest = VNGenerateImageFeaturePrintRequest { request, err in
    guard err == nil else { return }
    self.featurePrintResults = request.results
}
try handler.perform([faceQualityRequest, featurePrintRequest])

最佳方案：使用withThrowingTaskGroup批量处理请求 #

这个方案完美适配固定请求数量、需等待所有请求完成且要精准对应结果的场景，完全贴合Swift异步/并发的设计风格。

实现思路 #

1. 为单个Vision请求封装异步函数：用withCheckedThrowingContinuation将Completion Handler转为异步调用，简化单个请求的异步逻辑。
2. 用任务组批量启动异步请求：任务组可以统一管理多个并发任务，等待所有任务完成后再处理结果。
3. 精准匹配结果与类变量：通过给每个任务的结果添加类型标识，确保无序返回的结果能准确赋值到对应变量。

完整代码示例 #

// 扩展VNImageRequest，封装异步执行方法
extension VNImageRequest {
    func perform(with handler: VNImageRequestHandler) async throws -> [VNRequestResult] {
        try await withCheckedThrowingContinuation { continuation in
            self.completionHandler = { request, error in
                if let error = error {
                    continuation.resume(throwing: error)
                } else {
                    continuation.resume(returning: request.results ?? [])
                }
            }
            do {
                try handler.perform([self])
            } catch {
                continuation.resume(throwing: error)
            }
        }
    }
}

// 类中的异步处理方法
func processImage(at url: URL) async throws {
    let handler = VNImageRequestHandler(url: url)
    
    try await withThrowingTaskGroup(of: (type: String, results: [VNRequestResult]).self) { group in
        // 提交人脸质量检测任务
        group.addTask {
            let request = VNDetectFaceCaptureQualityRequest()
            let results = try await request.perform(with: handler)
            return (type: "faceQuality", results: results)
        }
        
        // 提交图像特征值生成任务
        group.addTask {
            let request = VNGenerateImageFeaturePrintRequest()
            let results = try await request.perform(with: handler)
            return (type: "featurePrint", results: results)
        }
        
        // 遍历任务结果，赋值到对应类变量
        for try await result in group {
            switch result.type {
            case "faceQuality":
                self.faceDetectionResults = result.results
            case "featurePrint":
                self.featurePrintResults = result.results
            default:
                break
            }
        }
    }
}

方案优势 #

• 适配固定请求数量：任务组可明确控制任务数量，等待所有任务完成后再统一处理，避免AsyncStream的无序遍历问题。
• 结果精准对应：通过类型标识，即使任务结果无序返回，也能准确匹配到对应的类变量。
• 符合Swift异步规范：利用原生async/await和任务组能力，代码可读性、可维护性远高于Completion Handler嵌套。
• 统一错误处理：任务组支持throwing类型，可集中处理所有请求的错误，避免冗余的错误判断代码。

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