为何XCTest等待Expectation时会阻塞异步后台Task？

你碰到的问题本质是：wait(for:timeout:)会阻塞测试主线程，而Swift Concurrency的Task在挂起恢复后，后续代码的调度依赖系统Executor。当测试主线程被阻塞时，后台Task里的exp.fulfill()可能无法被及时调度执行，导致Task看似一直挂起，直到超时后才完成。

虽然资料显示Expectation可与Task配合，但测试环境的线程调度限制会导致这种异常情况。

方案1：给Expectation的触发指定明确调度上下文 #

修改Task内部的exp.fulfill()，切换到主线程执行（XCTest的Expectation操作线程安全，主线程能确保触发时机）：

func testTask() async throws {
    let exp = expectation(description: "")
    print("Queuing")
    Task.detached(priority: .background) {
        let duration = try await ContinuousClock().measure {
            print("  Initialing task sleep")
            try await Task.sleep(for:.seconds(1))
        }
        print("  Fulfilling after \(duration)")
        // 切换到主线程执行fulfill，规避调度阻塞
        DispatchQueue.main.async {
            exp.fulfill()
        }
    }

    print("Waiting")
    wait(for: [exp], timeout: 4.0)
    print("Finished")
}

这个改动能让exp.fulfill()避开Task调度的限制，确保在主线程被wait阻塞时依然能正常执行。

方案2：用Async/Await替代传统Expectation #

既然你的测试方法已经声明为async throws，完全可以抛弃传统Expectation，使用Swift Concurrency原生的等待逻辑——这也是XCTest推荐的现代测试方式：

简单Task场景 #

直接await Task逻辑即可：

func testTask() async throws {
    print("Queuing")
    let duration = try await ContinuousClock().measure {
        print("  Initialing task sleep")
        try await Task.sleep(for:.seconds(1))
    }
    print("  Completed after \(duration)")
    print("Finished")
}

传统回调场景 #

针对你提到的真实代码中有传统完成回调的情况，可用withCheckedThrowingContinuation将回调逻辑包装为async函数：

假设你的后台任务代码是：

func triggerBackgroundTask(completion: @escaping (Result<Data, Error>) -> Void) {
    // 模拟后台任务逻辑
    DispatchQueue.global().asyncAfter(deadline: .now() + 1) {
        completion(.success(Data()))
    }
}

测试时的async适配写法：

func testBackgroundTask() async throws {
    print("Starting task")
    let resultData = try await withCheckedThrowingContinuation { continuation in
        triggerBackgroundTask { result in
            switch result {
            case .success(let data): continuation.resume(returning: data)
            case .failure(let error): continuation.resume(throwing: error)
            }
        }
    }
    // 这里可对resultData做断言
    print("Task finished")
}

这种方式完全贴合Swift Concurrency的调度逻辑，不会出现线程阻塞导致的调度异常。

如果要继续用Expectation，务必将exp.fulfill()切换到主线程执行；更推荐用Async/Await替代传统Expectation，尤其是在已经使用Swift Concurrency的代码中，能从根源避免这类调度问题。

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