Swift异步函数测试异常：XCTWaiter无论期望是否满足均显示成功

嘿，我之前也踩过这个坑！其实这和Swift版本关系不大，Swift3到Swift4的XCTest异步API几乎没变化，问题大概率出在你对XCTestExpectation和XCTWaiter的使用细节上，下面给你拆解最常见的几个原因和解决办法：

最可能的原因：忘记标记期望已完成 #

异步测试的核心逻辑是：你告诉测试“我要等某个操作完成”，操作完成后必须手动通知测试“我完事了”。如果没做第二步，测试要么超时失败，要么（更糟的是）因为主线程提前结束，直接显示“通过”——因为测试根本没等异步任务跑完！

你需要在asyncFunction的回调里调用expectation.fulfill()，同时别忘了调用wait(for:...)让测试进入等待状态。给你补全正确的代码示例：

func testAsyncFunction() {
    let expectation = XCTestExpectation(description: "异步函数执行完成")
    
    vc.asyncFunction(5) { result in
        // 先加业务断言验证结果是否符合预期（可选但推荐）
        XCTAssertEqual(result, 10, "异步函数返回结果不符合预期")
        // 关键：标记期望已满足
        expectation.fulfill()
    }
    
    // 必须调用wait方法，让测试等待期望，超时时间按需调整（比如5秒）
    wait(for: [expectation], timeout: 5.0)
}

其他可能的坑 #

• 漏写wait(for:...)方法：如果只创建了XCTestExpectation但没调用等待，测试的主线程会直接执行完testAsyncFunction就结束，异步任务还在后台跑，测试自然会显示“通过”——因为它根本没等结果。
• 异步函数没触发回调：比如你的asyncFunction内部逻辑出错，没走到闭包执行的环节。可以在回调里加个print("回调执行了")，看看是否真的触发了。
• 多个期望的管理问题：如果有多个期望，要确保每个都调用fulfill()，并且wait(for:)里传入所有期望数组。

总结一下：核心就是创建期望 → 在异步完成时标记完成 → 调用wait等待，这三步缺一不可，和Swift版本无关~

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