UI自动化稳定之道：从元素定位到环境配置的排坑手册

做UI自动化这几年踩过的坑比我写过的用例还多。最开始以为只要会用Selenium写脚本就行真正跑起来才发现问题一个接一个。元素定位不到、脚本时好时坏、换个浏览器就崩、CI上跑一片红这些问题几乎每个做UI自动化的测试工程师都遇到过。我自己从WebDriverManager、Selenium、Playwright一路折腾过来也看过很多团队从0搭建UI自动化最终跑不起来的核心原因往往不是工具不好用而是没把那些看似基础的坑填平。这篇文章我把这几年处理过的UI自动化高频问题整理成一套排查手册从元素定位、等待策略、环境配置到数据管理、用例稳定性全部是我实际跑过的场景和解决办法希望能给你省掉一些摸爬滚打的时间。1. 元素定位脚本最爱在这个环节翻车1.1 为什么明明能看到元素脚本就是找不到UI自动化最让人崩溃的错误就是NoSuchElementException。你打开浏览器元素明明就在页面上可脚本偏偏报找不到。我第一次遇到这种情况时怀疑是脚本写错了后来发现原因五花八门。最常见的一种是元素在iframe里。页面里嵌入了iframe而WebDriver默认只在主文档里查找元素你不切进去就永远找不到。解决办法是先定位到iframe元素再用switch_to.frame()切进去。这里有个小坑切进iframe之后如果还要操作主文档的内容记得再switch_to.default_content()切回来。另一种高频原因是元素是动态渲染出来的。现在前端框架基本都是Vue、React很多内容要等数据请求回来才渲染到DOM上。页面一开始根本没有这个元素脚本执行太快在元素出现之前就去查找了。这个本质是等待策略的问题后面第2节会详细讲。还有一类情况是元素存在但被遮挡比如弹窗浮层盖住了按钮或者页面还在滚动中。这种情况报的通常不是NoSuchElementException而是ElementClickInterceptedException点击的时候被拦截。我的经验是先检查有没有弹窗或遮罩层需要关掉再检查元素是否需要滚动到可视区域。1.2 定位策略不要神化XPath但也不要怕它很多教程上来就推荐用Chrome复制XPath我强烈不建议这么干。浏览器复制出来的XPath通常带着一长串div[3]/div[2]/span[1]这种绝对路径只要页面结构稍微一变就挂了。更可怕的是它对新人形成了一种误导定位元素就等于复制XPath。我自己的定位策略优先级是这样排的有id优先用id稳定而且易读没有id找name、class、>