一、分层设计自动化架构，解耦业务、元素、用例、底层驱动

高维护根源：代码耦合严重，页面 / 接口一改，所有脚本全量修改。采用分层设计隔离变化点。

1. UI 自动化：PO/POM 页面对象模型

分层：驱动层（selenium/appium/playwright）→公共工具层→Page 页面层（只存放元素定位、页面操作）→业务用例层（只写业务流程、断言）

收益：页面按钮、输入框、弹窗发生变化，只修改 Page 层一处，所有调用该元素的用例无需改动；业务流程调整仅改动用例层，不碰底层定位。

配套优化：统一封装等待、弹窗关闭、截图、日志、异常重试公共方法，避免每个脚本重复写等待逻辑。

2. 接口自动化：三层拆分（接口层、业务层、场景用例层）

接口层：统一封装请求（get/post/put）、签名、token、加密、重试、日志，统一处理返回体；

API 对象层：每个接口单独封装入参、出参、基础路径；

业务场景层：基于多个 API 组装完整业务流程。

接口字段、地址、签名规则变更，仅修改 API 对象层，大量业务场景脚本不受影响。

3. 统一公共组件库

提取全局通用能力：登录、权限切换、文件上传、时间工具、随机造数、失败重跑、异常捕获；全业务线复用，不重复编码。

二、规范用例编写原则，减少脆弱脚本

1. UI 定位策略优化，大幅减少元素失效

优先稳定定位：id、测试专用属性 data-testid（前端配合埋专属测试标识，不随样式改版变动）；

禁止强依赖：绝对 XPath、纯文字匹配、动态随机 class、随机 ID；

兼容动态页面：增加显式等待、动态滚动、弹窗自动关闭封装，避免异步加载导致的间歇性失败。

2. 用例粒度合理拆分，低耦合、可复用

原子步骤复用：新增、查询、编辑、删除封装成公共步骤，多个场景调用；

区分基础流程用例和分支场景用例，基础流程统一维护；

避免超长单条用例：一条脚本只验证一个核心校验点，流程过长一旦中间失败，排查、修改成本极高。

3. 断言轻量化、弱依赖页面细节

UI 不要断言文字颜色、字体、边距等易变样式；样式校验交给视觉自动化专项；

接口优先校验核心业务字段、状态码、业务 code，不校验无关冗余返回字段；

多用模糊匹配、包含匹配，少用完全精确字符串匹配。

三、测试数据统一治理，消除数据脏污导致的假性失败

大量脚本维护工作浪费在处理脏数据、重复造数据、数据冲突：

数据与脚本分离

用 yaml/json/ 数据库统一管理测试数据，账号、手机号、订单号、参数不硬编码写在脚本内；业务变更只改数据文件。

自动化数据隔离与自动重置

每条用例前置自动创建隔离数据，后置自动清理；

提供公共接口重置环境、清空脏数据，避免多条用例互相干扰导致间歇性报错；

通用数据工厂

封装用户、订单、商品等通用造数方法，统一生成合法 / 异常 / 边界数据，不用每个脚本重复写造数逻辑。

四、引入 AI 与视觉自动化，实现脚本自愈，减少人工修复

面向未来全域质量方案，从 “人工改脚本” 转向 “AI 自动修复”：

多视觉定位兜底

传统定位失效时，自动启用图像识别、OCR 辅助定位；页面小幅改版无需手动更新 XPath / 选择器。

脚本自愈能力

AI 识别元素失效后，自动重新抓取页面 DOM、匹配新定位方式，自动更新 Page 对象定位信息，批量修复失效用例；

大模型辅助批量更新脚本

接口文档、需求变更后，大模型批量识别变更字段，自动批量修改接口请求参数、断言，减少逐条修改工作量。

五、平台化、低代码降低脚本修改门槛，统一管控

搭建一体化自动化平台，屏蔽底层驱动细节

测试人员无需修改底层框架代码，仅可视化配置页面元素、接口参数、业务流程；页面改动仅在平台界面更新配置，不写代码。

统一用例仓库、版本管理

所有脚本纳入 Git / 平台版本管理，变更留痕；支持对比需求变更批量检索受影响用例，精准定位需要维护的脚本，不用全量排查。

环境统一调度，消除环境差异维护成本

容器化一键拉起干净测试环境，自动初始化基础数据；环境不稳定、服务宕机自动重跑、自动重置，减少因环境问题反复调试脚本。

六、流程左移 + 前后端协同，从源头减少脚本改动

脚本维护成本本质来自业务频繁变更，提前协同可大幅减少后期修改：

前端规范埋点 data-testid

开发迭代页面时保留专属测试标识，不随意删除、修改；UI 改版不会破坏自动化定位。

需求变更提前评估自动化影响

需求评审阶段同步评估：页面、接口改动会影响哪些自动化场景，提前同步测试，迭代阶段同步更新脚本，避免版本上线后批量脚本崩溃。

契约测试前置

前后端 / 微服务之间通过契约文件约定入参出参，接口变更先更新契约，自动化脚本同步适配，提前拦截不兼容改动。

七、工程化策略：清理、分层执行、分层维护，控制脚本总量

定期清理废弃用例

下线业务、废弃流程的脚本及时归档删除，减少无效脚本维护负担；区分主干核心回归用例与低频场景用例，分开管理。

分级自动化执行策略

P0 核心链路：高频维护、每次迭代必跑；

P1 次要场景：迭代回归执行，按月统一维护；

P2 低频边缘场景：不纳入流水线，定期手动补充校验，不用投入大量人力维护；

避免不分优先级维护全部脚本。

失败用例自动化分类，区分缺陷 / 环境 / 脚本问题

通过日志、链路分析自动标记失败原因：

业务 Bug：提缺陷，无需改脚本；

环境 / 数据问题：自动重跑、重置环境；

脚本元素 / 接口变更：标记待维护清单，批量集中修复；

减少人工逐条排查的时间损耗。

八、配套规范与团队机制保障

制定自动化编码规范：强制分层、禁止硬编码、统一等待与异常处理，避免新人写出高维护成本的 “一次性脚本”；

脚本变更随需求同步迭代：开发改接口 / 页面，测试同步更新自动化，不堆积到版本末期统一修复；

公共组件共建共享：跨业务线通用能力沉淀到公共库，避免重复造轮子，一处优化全团队受益。