Swift iOS单元测试校验UIAlertController弹窗异常问题排查

核心问题根源 #

你当前的测试存在三个致命问题，直接导致CI环境下测试串扰、断言错配到其他快照测试：

• 测试生命周期未闭环：创建了XCTestExpectation但从未调用wait(for:timeout:)阻塞测试流程，测试方法在调度完1秒延迟任务后会立刻执行结束，当前测试上下文随即销毁。1秒后延迟闭包执行时，XCTest框架已经在运行同进程内的其他测试用例，抛出的断言失败自然会被归属到当时正在执行的其他测试上。
• 测试上下文未做隔离：没有为被测视图控制器创建独立的测试承载窗口，默认依赖App全局UI栈，CI环境下测试并行执行时，其他测试用例弹出的控制器、快照测试渲染的页面会直接污染当前测试的视图层级。
• 时序不可靠+校验粒度过粗：使用固定1秒的asyncAfter延迟等待弹窗展示，本地机器资源充足时可能刚好符合时序，CI资源紧张时会出现弹窗还未展示完成就执行断言、或者其他测试的弹窗刚好插入的问题；同时仅校验presentedViewController是UIAlertController类型，无法区分弹窗是不是当前测试触发的目标弹窗。

正确测试实现 #

首先要做测试上下文隔离，每个测试用例使用独立的UIWindow承载被测VC，在setUp阶段初始化、tearDown阶段彻底销毁，完全不污染全局UI栈；其次移除固定延迟，使用系统提供的present完成回调触发断言，保证时序准确；最后必须调用wait方法闭环测试生命周期，同时做精细化的内容校验。

class TransactionsListViewControllerTests: XCTestCase {

    private var viewController: MockTransactionsListViewController!
    // 每个测试用例独立的测试窗口，完全隔离全局UI栈
    private var testWindow: UIWindow!

    override func setUpWithError() throws {
        try super.setUpWithError()
        // 初始化被测VC
        viewController = MockTransactionsListViewController()
        // 初始化和屏幕等大的独立测试窗口，不使用App全局keyWindow
        testWindow = UIWindow(frame: UIScreen.main.bounds)
        testWindow.rootViewController = viewController
        testWindow.makeKeyAndVisible()
        // 强制触发VC视图加载生命周期
        viewController.loadViewIfNeeded()
    }

    override func tearDownWithError() throws {
        // 彻底销毁测试相关引用，清空窗口，避免残留状态影响其他测试
        viewController = nil
        testWindow.isHidden = true
        testWindow.rootViewController = nil
        testWindow = nil
        try super.tearDownWithError()
    }

    func testPresentAlertForAccountInCollection() throws {
        // 加载测试用弹窗配置
        let fetchAlertContent = try retrieveAlertContent(mockPath: "alertContent.json", refresh: false)
        if let error = fetchAlertContent.result?.error {
            XCTFail(error.localizedDescription)
            return
        }

        // 构造预期的目标弹窗
        let expectedAlertController = UIAlertController(
            title: fetchAlertContent.title,
            message: fetchAlertContent.description,
            preferredStyle: .alert
        )
        let okButton = UIAlertAction(title: fetchAlertContent.buttonTitle, style: .default)
        expectedAlertController.addAction(okButton)

        // 使用present自带的completion回调做断言，时序100%准确，无需固定延迟
        let presentExpectation = expectation(description: "Target alert presented successfully")
        viewController.present(expectedAlertController, animated: false) {
            // 先校验展示的控制器类型
            guard let presentedAlert = self.viewController.presentedViewController as? UIAlertController else {
                XCTFail("Presented view controller is not UIAlertController type")
                presentExpectation.fulfill()
                return
            }
            // 校验展示的弹窗就是当前测试构造的目标实例，排除其他弹窗干扰
            XCTAssertEqual(presentedAlert, expectedAlertController)
            // 校验弹窗内容完全符合预期
            XCTAssertEqual(presentedAlert.title, fetchAlertContent.title)
            XCTAssertEqual(presentedAlert.message, fetchAlertContent.description)
            XCTAssertEqual(presentedAlert.actions.count, 1)
            XCTAssertEqual(presentedAlert.actions.first?.title, fetchAlertContent.buttonTitle)
            XCTAssertEqual(presentedAlert.actions.first?.style, .default)
            
            presentExpectation.fulfill()
        }

        // 核心：必须调用wait方法阻塞当前测试，直到断言逻辑全部执行完成，避免上下文飘移
        wait(for: [presentExpectation], timeout: 2.0)
    }
}

关键优化点说明 #

• 彻底解决跨测试串扰：独立测试窗口+setUp/tearDown全生命周期管理，从根源上阻断其他测试的视图栈污染当前测试上下文。
• 彻底解决时序不稳定问题：移除固定延迟，直接在present完成回调中执行断言，不存在等待时长不足或过长的问题。
• 彻底解决断言错配问题：wait方法会阻塞测试方法直到所有逻辑执行完成，所有断言都运行在当前测试的上下文内，不会出现测试结束后闭包才执行、断言被归属到其他测试的问题。
• 校验逻辑更严谨：从仅校验类型，升级为校验弹窗实例身份、标题、内容、按钮属性，不会误匹配其他逻辑弹出的UIAlertController。

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