Swift UI测试中API返回结果等待及城市名称校验失败问题排查

API 探路者

2026-10-1

问题原因及解决方案

核心问题

断言失败确实是异步等待逻辑缺失导致的：XCUI测试执行是同步的，点击Check weather按钮后会立刻执行下一行断言，不会等待API请求完成、页面渲染完成，此时城市名称的文本还没出现在UI层级里，自然会断言失败。
不要用固定时长的定时器（比如sleep()），这种方案兼容性极差，网络波动时要么超时要么浪费测试时间，苹果官方提供了XCTestExpectation专门处理异步等待场景。

修正后的代码

func testExample() throws {
    let app = XCUIApplication()
    app.launchArguments = ["enable-testing"]
    app.launch()
    
    app.staticTexts["My location"].tap()
    addUIInterruptionMonitor(withDescription: "Allow “APP” to access your location?") { (alert) -> Bool in
        let button = alert.buttons["Only While Using the App"]
        if button.exists {
            button.tap()
            return true
        }
        return false
    }
    // 加完中断监视器后调用一次app.tap()触发系统检测弹窗，避免部分场景下监视器不生效
    app.tap()
    
    app.textFields["Enter your city"].tap()
    app.textFields["Enter your city"].typeText("Barcelona")
    
    app.buttons["Check weather"].tap()
    
    // 新增异步等待逻辑：等待Barcelona文本出现，最多等5秒，时长可根据实际情况调整
    let cityLabel = app.staticTexts["Barcelona"]
    let existsPredicate = NSPredicate(format: "exists == true")
    expectation(for: existsPredicate, evaluatedWith: cityLabel, handler: nil)
    waitForExpectations(timeout: 5, error: "等待城市名称加载超时，API请求可能失败或UI渲染逻辑存在问题")
    
    // 等待通过后再执行断言
    XCTAssertTrue(cityLabel.exists)
}