【Appium 系列】第13节-混合测试执行器 — API + UI 的协同执行

对应代码配套代码/test/core/hybrid_test_executor.py说明本节讲解当一个测试用例需要同时使用接口测试和 UI 测试时如何协调执行。这节讲什么有些测试用例光靠接口测试或 UI 测试都不够。比如验证用户注册后能登录这个用例需要先通过接口创建用户数据准备再通过 UI 验证登录流程用户体验如果只用接口测试验证不了 UI 层面的问题比如按钮没响应、页面跳转错误 如果只用 UI 测试数据准备太慢需要通过 UI 手动填写注册表单混合测试就是为了解决这个问题接口负责数据准备UI 负责体验验证。两者协同各取所长。核心思路混合测试的执行流程测试用例 ↓ 步骤 1: 接口准备数据快速、稳定 ↓ 步骤 2: UI 验证功能覆盖用户体验 ↓ 汇总结果为什么需要混合测试场景纯接口测试纯 UI 测试混合测试数据准备快慢接口准备用户体验验证覆盖不了全覆盖UI 验证执行时间1-2 秒30-60 秒15-30 秒稳定性高低依赖设备中混合测试折中了时间和覆盖度用接口快速准备数据用 UI 验证核心体验。实战案例案例用户注册后登录name: 验证用户注册后能成功登录 test_type: hybrid # 明确指定混合测试 # 接口步骤准备测试数据 api_steps: - action: post path: /api/register json: username: testuser password: test123 expect_status: 201 # UI 步骤验证登录体验 steps: - action: click target: login_button - action: input target: username_field value: testuser - action: input target: password_field value: test123 - action: click target: submit_button - action: verify target: welcome_text expect: 欢迎testuser执行流程接口阶段调用/api/register创建用户1 秒UI 阶段打开登录页面输入账号密码点击登录验证欢迎文本15 秒汇总两个阶段都通过才算通过代码实现核心代码在core/hybrid_test_executor.pyclass HybridTestExecutor: def execute(self, test_case, driverNone, api_clientNone): test_type TestRouter.determine_test_type(test_case) if test_type TestType.HYBRID: return self._execute_hybrid_test(test_case, driver, api_client) def _execute_hybrid_test(self, test_case, driver, api_client): result { test_case: test_case[name], test_type: hybrid, api_result: {}, ui_result: {} } # 步骤 1: 接口准备数据 api_steps test_case.get(api_steps, []) if api_steps and api_client: api_result self._execute_api_test( {name: 数据准备, steps: api_steps}, api_client ) result[api_result] api_result # 接口失败则直接返回 if api_result[status] failed: result[status] failed result[message] 接口数据准备失败 return result # 步骤 2: UI 验证 ui_steps test_case.get(steps, []) if ui_steps and driver: ui_result self._execute_ui_test( {name: test_case[name], steps: ui_steps}, driver ) result[ui_result] ui_result if ui_result[status] failed: result[status] failed result[message] UI 验证失败 return result # 都通过 result[status] passed result[message] 混合测试通过 return result注意事项1. 接口失败的处理如果接口数据准备失败不要继续执行 UI 步骤。因为 UI 验证依赖接口准备的数据数据没准备好UI 验证必然失败。建议接口失败时立即返回记录错误信息方便排查是接口问题还是环境问题。2. UI 失败的截图UI 验证失败时一定要截图。因为 UI 问题往往是视觉层面的比如元素没显示、布局错乱光看日志看不出问题。建议在_execute_ui_test的 except 块中调用driver.get_screenshot_as_file()保存失败时的页面状态。3. 数据清理混合测试完成后需要清理接口创建的数据。否则多次执行会积累大量测试数据影响后续测试。建议在测试用例的teardown阶段添加清理步骤或者使用唯一用户名如testuser_12345避免冲突。4. 执行顺序必须先接口后 UI不能反过来。因为 UI 验证依赖接口准备的数据。如果先执行 UI数据还没准备好验证必然失败。混合测试的适用场景混合测试不是万能药它适合特定的场景。以下是判断该不该用混合测试的参考标准适合用混合测试的场景注册→登录→下单数据准备用接口快核心流程用 UI 验证全后台配置→前端展示接口修改配置UI 验证展示效果批量数据准备→单点验证接口批量创建 100 条数据UI 验证分页/搜索/筛选跨系统协作接口调用外部系统触发事件UI 验证本系统响应不适合用混合测试的场景纯 UI 交互验证比如动画效果、手势操作、拖拽排序——这些跟接口无关纯 UI 测试就行纯接口压力测试比如并发 1000 请求——不需要 UI接口测试更合适用例数量少的项目混合测试增加了用例设计的复杂度小项目用不上判断标准如果一个测试场景满足数据准备耗时 UI 验证耗时或者数据准备步骤 3 步就值得考虑混合测试。否则选纯 API 或纯 UI 更简单。