自动化测试最打击信心的情况，是功能没坏，测试却天天红。很多团队第一反应是加等待、加重试、提高超时时间，结果测试更慢也更不可信。真正要先看的，往往是选择器到底稳不稳。
这篇文章不打算把稳定选择器讲成抽象原则，而是放到真实项目里拆：它受哪些机制影响，哪里需要提前定责，失败以后怎样恢复。我的取舍是，先让状态和责任可解释，再追求漂亮的封装或更快的路径。
选择器不是随手复制
从浏览器里复制一串 XPath 很快，但它通常绑定了层级、样式和临时结构。页面稍微改版，测试就会碎。 这一步的价值不是让流程变得复杂，而是把隐含假设摊到桌面上。只要假设能被看见，开发、测试和产品就能围绕同一个边界讨论，而不是在问题出现后各自补解释。
在机制上，data-testid、语义角色、页面对象、DOM 变化、等待条件会一起影响稳定选择器。它们不是文档里的并列名词，而是会在一次真实操作里互相拖拽：一个环节慢了、断了、被重试了，后面的状态就会跟着变化。
落地时可以先做一个小动作：优先用角色、文本、业务 id 或 data-testid 定位关键元素。 这件事不一定需要大改架构，但它能让问题发生时留下足够线索。很多难查的问题，缺的不是技术能力，而是最开始没有留下可追的痕迹。
这里的反面例子也要写清：把 class 名当稳定选择器，容易被样式改动影响。 它通常不会在演示环境暴露，因为演示路径短、数据少、角色单一；一旦进入真实用户和长期运行，问题就会变得很难复盘。
我会用一个朴素标准判断这一段是否完成：页面样式或布局调整后，测试不应该因为无关 DOM 变化失败。如果团队回答这个问题时还要靠猜，说明稳定选择器仍然停留在口头规则，没有真正进入实现和验收。
这张图只画和“选择器不是随手复制”直接相关的路径，重点是让边界、状态和失败出口都能被看见。
测试标识要有命名规则
data-testid 不是越多越好，也不是随便写。它应该对应业务动作和稳定对象，让测试读起来像用户路径。 这一步的价值不是让流程变得复杂，而是把隐含假设摊到桌面上。只要假设能被看见，开发、测试和产品就能围绕同一个边界讨论，而不是在问题出现后各自补解释。
放到“测试标识要有命名规则”这一节，这些机制不是背景板，data-testid、语义角色、页面对象、DOM 变化、等待条件会一起影响稳定选择器。它们不是文档里的并列名词，而是会在一次真实操作里互相拖拽：一个环节慢了、断了、被重试了，后面的状态就会跟着变化。
落地时可以先做一个小动作：用页面名、模块名、动作名组成标识。 这件事不一定需要大改架构，但它能让问题发生时留下足够线索。很多难查的问题，缺的不是技术能力，而是最开始没有留下可追的痕迹。
这里的反面例子也要写清：无规则命名会让后续维护者找不到元素来源。 它通常不会在演示环境暴露，因为演示路径短、数据少、角色单一；一旦进入真实用户和长期运行，问题就会变得很难复盘。
对“测试标识要有命名规则”来说，验收标准可以更具体一点：页面样式或布局调整后，测试不应该因为无关 DOM 变化失败。如果团队回答这个问题时还要靠猜，说明稳定选择器仍然停留在口头规则，没有真正进入实现和验收。
针对“测试标识要有命名规则”，可以把检查清单压成三项：先确认对象是谁，再确认它的生命周期在哪里结束，最后确认失败以后谁负责接手。清单越短，越能逼出真正关键的规则。
等待条件要等业务就绪
测试失败很多来自时机问题。比起固定 sleep，更应该等待接口完成、按钮可用、列表渲染完成等业务条件。 这一步的价值不是让流程变得复杂，而是把隐含假设摊到桌面上。只要假设能被看见，开发、测试和产品就能围绕同一个边界讨论，而不是在问题出现后各自补解释。
放到“等待条件要等业务就绪”这一节，这些机制不是背景板，data-testid、语义角色、页面对象、DOM 变化、等待条件会一起影响稳定选择器。它们不是文档里的并列名词，而是会在一次真实操作里互相拖拽：一个环节慢了、断了、被重试了，后面的状态就会跟着变化。
落地时可以先做一个小动作：把等待条件封装在页面对象里。 这件事不一定需要大改架构，但它能让问题发生时留下足够线索。很多难查的问题，缺的不是技术能力，而是最开始没有留下可追的痕迹。
这里的反面例子也要写清：到处写 sleep 会让测试慢，还不能真正稳定。 它通常不会在演示环境暴露，因为演示路径短、数据少、角色单一；一旦进入真实用户和长期运行，问题就会变得很难复盘。
对“等待条件要等业务就绪”来说，验收标准可以更具体一点：页面样式或布局调整后，测试不应该因为无关 DOM 变化失败。如果团队回答这个问题时还要靠猜，说明稳定选择器仍然停留在口头规则，没有真正进入实现和验收。
这张图只画和“等待条件要等业务就绪”直接相关的路径，重点是让边界、状态和失败出口都能被看见。
下面这段只作为边界表达示例，不建议脱离业务直接复制：
- await page.getByTestId("order-submit-button").click()
- await expect(page.getByRole("alert")).toContainText("提交成功")
页面对象隔离 DOM 细节
测试用例应该描述用户行为，不应该充满 DOM 查询细节。页面对象可以把选择器变化收口在一个地方。 这一步的价值不是让流程变得复杂，而是把隐含假设摊到桌面上。只要假设能被看见，开发、测试和产品就能围绕同一个边界讨论，而不是在问题出现后各自补解释。
放到“页面对象隔离 DOM 细节”这一节，这些机制不是背景板，data-testid、语义角色、页面对象、DOM 变化、等待条件会一起影响稳定选择器。它们不是文档里的并列名词，而是会在一次真实操作里互相拖拽：一个环节慢了、断了、被重试了，后面的状态就会跟着变化。
落地时可以先做一个小动作：用页面对象暴露点击、填写、提交、断言入口。 这件事不一定需要大改架构，但它能让问题发生时留下足够线索。很多难查的问题，缺的不是技术能力，而是最开始没有留下可追的痕迹。
这里的反面例子也要写清：每个用例自己查 DOM，改一次页面会改很多测试。 它通常不会在演示环境暴露，因为演示路径短、数据少、角色单一；一旦进入真实用户和长期运行，问题就会变得很难复盘。
对“页面对象隔离 DOM 细节”来说，验收标准可以更具体一点：页面样式或布局调整后，测试不应该因为无关 DOM 变化失败。如果团队回答这个问题时还要靠猜，说明稳定选择器仍然停留在口头规则，没有真正进入实现和验收。
针对“页面对象隔离 DOM 细节”，可以把检查清单压成三项：先确认对象是谁，再确认它的生命周期在哪里结束，最后确认失败以后谁负责接手。清单越短，越能逼出真正关键的规则。
失败截图要能定位
自动化失败后，只给一行元素找不到很难排查。截图、当前 URL、关键接口响应和 DOM 片段都能帮助判断是功能问题还是测试问题。 这一步的价值不是让流程变得复杂，而是把隐含假设摊到桌面上。只要假设能被看见，开发、测试和产品就能围绕同一个边界讨论，而不是在问题出现后各自补解释。
放到“失败截图要能定位”这一节，这些机制不是背景板，data-testid、语义角色、页面对象、DOM 变化、等待条件会一起影响稳定选择器。它们不是文档里的并列名词，而是会在一次真实操作里互相拖拽：一个环节慢了、断了、被重试了，后面的状态就会跟着变化。
落地时可以先做一个小动作：失败时保存截图和最近一次网络记录。 这件事不一定需要大改架构，但它能让问题发生时留下足够线索。很多难查的问题，缺的不是技术能力，而是最开始没有留下可追的痕迹。
这里的反面例子也要写清：没有诊断信息，稳定性问题会被当成偶发。 它通常不会在演示环境暴露，因为演示路径短、数据少、角色单一；一旦进入真实用户和长期运行，问题就会变得很难复盘。
对“失败截图要能定位”来说，验收标准可以更具体一点：页面样式或布局调整后，测试不应该因为无关 DOM 变化失败。如果团队回答这个问题时还要靠猜，说明稳定选择器仍然停留在口头规则，没有真正进入实现和验收。
别让稳定性只靠重试撑住
自动化测试不稳定时，加重试是最诱人的处理方式，因为它看起来立刻降低红灯数量。但如果根因是选择器不稳或等待条件不对，重试只是把问题延后。
更好的顺序是先定位失败类型：元素不存在、元素存在但不可点、接口未返回、动画未结束、断言数据不一致。不同失败类型对应不同修法，不能全靠 retry。
每周可以抽查失败用例，把“产品缺陷”和“测试脚本问题”分开统计。只有当测试问题持续下降，自动化才真的在变稳。
选择器规范要进评审
稳定选择器不是测试同学一个人的事。开发改页面时，如果随手删除 data-testid 或改变关键语义，自动化会被动失效。
比较稳的方式是把测试标识纳入组件评审：关键按钮、关键输入、关键状态都要有稳定入口。这样自动化测试不是事后补丁，而是页面可测试性的一部分。
自动化先稳选择器的验收样本
最后还要补一组验收样本。样本不需要覆盖所有情况，但要覆盖正常、异常、边界和恢复。对“自动化先稳选择器”来说，只有这四类样本都能解释，文章里的建议才不是停留在原则层面。
我会特别关注恢复样本：失败后状态是否可追，下一次是否能继续，重复执行是否安全。很多系统不是败在第一次失败，而是败在失败后的第二次处理。
最后用三个问题收住
第一，谁拥有稳定选择器的最终解释权。没有 owner 的规则，短期靠人记，长期靠运气。
第二，失败以后系统会留下什么证据。证据不是越多越好，而是要能回答：发生在什么条件下、处理到哪一步、下一次应该从哪里恢复。
第三，这个方案适合哪些场景、不适合哪些场景。选择器越贴近实现越容易写，越贴近用户语义越稳定；两者需要按场景取舍。，所以不要把一次有效实践包装成万能答案。
如果这三个问题能说清，稳定选择器就不再只是一个技术点，而会变成团队协作中的稳定边界。后续无论换框架、换人员还是换业务规模，都能沿着这条边界继续调整。