如何让XCTest异步测试断言失败后立即停止执行？

默认情况下，XCTest的XCTAssert系列断言仅会记录测试失败，但不会中断异步async函数的执行流程，这就导致断言失败后后续代码仍会运行（比如你示例里的print("xxxxxxx")）。要实现断言失败即终止测试，需要结合抛出错误的方式，因为async throws函数在抛出错误时会立即停止执行。

解决方案1：直接在断言失败后抛出错误 #

通过guard判断条件，失败时调用XCTFail记录错误，再抛出一个自定义错误终止测试：

@MainActor func testAsync() async throws {
    guard false else { // 替换成你的实际断言条件
        XCTFail("断言失败")
        throw NSError(domain: "TestFailure", code: 1, userInfo: [NSLocalizedDescriptionKey: "断言失败，终止测试"])
    }
    print("xxxxxxx") // 断言失败时不会执行这段代码
}

解决方案2：封装自定义抛出型断言 #

如果需要多次使用，可以封装一个自定义断言函数，简化代码：

// 定义自定义测试错误
enum TestError: Error {
    case assertionFailed(message: String)
}

// 封装抛出型断言
@MainActor func XCTAssertOnFailThrow(_ condition: @autoclosure () -> Bool, message: @autoclosure () -> String = "", file: StaticString = #filePath, line: UInt = #line) throws {
    guard condition() else {
        let failMessage = message()
        XCTFail(failMessage, file: file, line: line)
        throw TestError.assertionFailed(message: failMessage)
    }
}

// 使用示例
@MainActor func testAsync() async throws {
    try XCTAssertOnFailThrow(false, message: "条件不满足")
    print("xxxxxxx") // 断言失败时不会执行
}

原理说明 #

async throws类型的测试函数中，一旦抛出错误，XCTest会立即捕获并标记测试失败，同时终止函数的后续执行流程，完美解决你需要的“断言失败即停止”的需求。

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