SwiftUI XCTest测试通过accessibility identifier访问NavigationLink失败如何解决

错误原因 #

你在测试代码中将查找范围限定为navigationBars下的链接元素，但你定义的NavigationLink是放在页面普通视图层级中，不属于导航栏的子元素，因此系统无法匹配到对应元素，触发找不到元素的报错。

修正方案 #

调整测试代码的元素查找逻辑，不需要限定从导航栏下查找：

func testLoginActionAndNavigation() throws {
    // 先确保app实例已完成初始化
    let app = self.app
    // 查找全局范围内的对应链接，增加3秒等待时间避免页面未渲染完成就执行查找
    let linkLogin = app.links["linkLogin"]
    XCTAssertTrue(linkLogin.waitForExistence(timeout: 3))
    linkLogin.tap()
    
    // 原校验逻辑不合理：点击NavigationLink跳转后原页面元素已消失，应该校验目标页面是否成功加载
    // 建议先给TabBarDashboardView添加accessibilityIdentifier，比如 "TabBarDashboard"
    let dashboard = app.otherElements["TabBarDashboard"]
    XCTAssertTrue(dashboard.waitForExistence(timeout: 3))
}

额外优化建议 #

• 如果你的需求确实是要把登录入口放在导航栏中，需要把NavigationLink包裹在.toolbar修饰符内，此时才可以从navigationBars下匹配到该元素。
• 所有UI测试中需要定位的视图都建议显式添加accessibility(identifier:)，不要依赖文案或者系统自动生成的标识符，提升测试用例的稳定性。
• 所有元素操作前都建议加waitForExistence校验，避免异步渲染导致的偶现测试失败。

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