一、为什么UI自动化脚本总是不稳定？

UI自动化测试最折磨人的就是“昨天全绿，今早全红”，而且复现还特别费劲。脚本脆弱不堪，页面稍一变动就导致大批用例失败。本文将从定位策略、等待机制、失败重试三个核心角度，教你如何让脚本变得“皮实”。

二、优化一：拥抱data-testid，告别脆弱定位

2.1 传统定位方式的问题

最经典的错误是使用易变的CSS类或ID来定位元素，例如：

css

#main > div.button > span

一旦开发调整了样式，测试立刻崩溃。

2.2 解决方案：data-testid

与开发团队约定，为所有需要测试交互的元素添加专用的data-testid属性：

html

<button data-testid="login-submit-btn">登录</button> <input data-testid="username-input" type="text" /> <input data-testid="password-input" type="password" />

在测试脚本中定位：

javascript

// Playwright await page.locator('[data-testid="login-submit-btn"]').click(); // Selenium WebDriver driver.findElement(By.cssSelector('[data-testid="login-submit-btn"]'));

这样做的好处是：测试与样式解耦，只要业务功能不变，定位器就坚如磐石。

2.3 团队协作建议

• 在PR检查中要求核心UI元素必须加data-testid

• 约定统一的命名规范，如{模块}-{功能}-{元素类型}

• 将data-testid视为代码与测试之间的契约，跨版本保持稳定

三、优化二：智能等待替代硬编码Sleep

3.1 为什么不能用Thread.sleep？

使用Thread.sleep(5000)是测试脚本的“毒药”：

• 如果元素提前加载完成，浪费时间

• 如果网络慢5秒不够，测试依然失败

3.2 三种等待策略对比

3.3 显式等待实战

错误示范：

javascript

await page.waitForTimeout(5000); await page.click('button');

正确示范（Playwright）：

javascript

await page.waitForSelector('button', { state: 'visible', timeout: 10000 }); await page.click('button');

正确示范（Selenium WebDriver）：

java

WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10)); WebElement button = wait.until(ExpectedConditions.elementToBeClickable(By.id("submit"))); button.click();

3.4 等待策略的最佳实践

1. 隐式等待设个底兜（如10秒），告诉驱动“找不到就多等会儿”

2. 显式等待是主力：针对每个关键操作，明确等待特定条件（元素可点击、可见等）

3. 避免隐式等待和显式等待混用，否则可能导致不可预期的超时行为

四、优化三：失败重试机制

4.1 为什么要重试？

网络偶尔抖动、CPU偶尔飙高，第一次失败可能是环境问题，第二次失败才可能是真正的Bug。失败重试可以让用例自动“抢救”自己。

4.2 TestNG的IRetryAnalyzer实现

Step 1：创建重试分析器类

java

import org.testng.IRetryAnalyzer; import org.testng.ITestResult; public class TestRetry implements IRetryAnalyzer { private int retryCount = 0; private static final int MAX_RETRY_COUNT = 2; // 最多重试2次 @Override public boolean retry(ITestResult result) { if (retryCount < MAX_RETRY_COUNT) { retryCount++; return true; // 返回true表示需要重试 } return false; } }

Step 2：在测试方法上使用

java

@Test(retryAnalyzer = TestRetry.class) public void testLogin() { // UI自动化测试代码 }

4.3 重试机制的最佳实践

• 限制重试次数：建议1-2次，避免掩盖真正的缺陷

• 配合截图和日志：重试时记录失败现场，便于问题定位

• 只对特定类型的失败重试：如ElementNotFoundException，而不是所有断言失败

五、总结

UI自动化脚本稳定性优化的三个核心策略：

一句总结：用好data-testid、告别sleep、开启自动重试，稳定率能从60%飙到90%以上。