本文介绍在 UI 加载元素（如 AJAX 动画）短时间内连续出现两次时，如何可靠等待其彻底消失两次，避免因过早操作导致的元素不可用问题，无需使用 Thread.sleep()。
本文介绍在 ui 加载元素（如 ajax 动画）短时间内连续出现两次时，如何可靠等待其**彻底消失两次**，避免因过早操作导致的元素不可用问题，无需使用 `thread.sleep()`。
在 Web 自动化测试中，ExpectedConditions.invisibilityOfElementLocatedBy() 是处理加载动画的标准方式，但它仅校验“元素是否当前不可见”，无法感知动画是否已完整完成两轮显示-隐藏周期。当 uiLoader 因连续异步请求在极短时间内（例如 300ms 内）闪现两次时，单次或重复调用 invisibilityOf() 极易误判——因为第一次消失后，WebDriver 立即通过等待，而此时第二次加载动画可能尚未开始或刚出现，导致后续操作失败。
要真正解决“等待两次消失”这一语义需求，关键在于监控状态变化而非静态快照。推荐使用 Awaitility ——一个专为异步断言设计的 Java 库，它支持基于时间窗口、重试策略与异常抑制的灵活等待逻辑，比原生 WebDriverWait 更适合此类复合条件场景。
✅ 推荐方案：用 Awaitility 监控两次“从可见到不可见”的转换
由于 Selenium 本身不提供“监听元素可见性变化次数”的内置条件，我们转而采用时间窗口内持续断言不可见 + 容忍瞬时异常的策略。以下是一个鲁棒实现：
import static org.awaitility.Awaitility.await;
import static java.time.Duration.ofSeconds;
public void handleUILoadingTwice() {
// 等待至少 2 秒，期间忽略 StaleElementReferenceException 等临时异常
await()
.atLeast(ofSeconds(2)) // 最小等待时长，覆盖两次动画周期（含间隔）
.pollInterval(ofSeconds(1)) // 每秒检查一次（避免过度轮询）
.ignoreExceptions(
StaleElementReferenceException.class,
NoSuchElementException.class
)
.until(() -> !uiLoader.isDisplayed());
}
⚠️ 注意事项：
- uiLoader 必须是动态查找的 WebElement（例如通过 driver.findElement(...) 获取），而非页面初始化时缓存的旧引用，否则可能抛出 StaleElementReferenceException；建议在 until() lambda 中重新定位：() -> !driver.findElement(By.id("loader")).isDisplayed()。
- atLeast(2) 并非“最多等 2 秒”，而是确保整个等待过程不低于 2 秒，以覆盖典型双加载场景（如首次加载 500ms + 间隔 300ms + 第二次加载 500ms ≈ 1.3s），避免因过短窗口漏检第二次出现。
- 若需严格验证“恰好两次”，可结合计数器 + WebElement.getAttribute("style") 或 CSS 类名变化（如 loading--active）做状态跟踪，但会显著增加复杂度；对绝大多数业务场景，上述“稳态不可见+时间兜底”已足够可靠。
✅ 替代方案（纯 Selenium，适用于轻量级场景）
若项目无法引入 Awaitility，可通过循环 + 显式时间戳记录实现简易版双消失检测：
public void handleUILoadingTwiceSeleniumOnly() {
WebDriverWait wait = new WebDriverWait(driver, 50);
long lastInvisibleTime = 0;
int invisibleCount = 0;
final long MIN_GAP_MS = 300; // 两次消失需间隔至少 300ms 才计为独立事件
while (invisibleCount MIN_GAP_MS) {
invisibleCount++;
lastInvisibleTime = now;
}
} catch (TimeoutException e) {
// 超时说明元素仍可见，重试
continue;
}
}
}
该方案虽可行，但代码冗长且依赖时间阈值经验设定。相比之下，Awaitility 提供声明式语法、自动重试与异常治理，是更专业、可维护的选择。
总之，面对 UI 加载动画的多阶段行为，应跳出“单次不可见即安全”的思维定式，转向基于时间窗口、状态演化与异常韧性的等待策略——这正是现代自动化测试稳定性的核心所在。
