测试自动化平台 使用文档

项目概述

本平台由两个子项目组成：

平台支持两大核心能力：接口自动化测试 和 UI 自动化测试，并提供 AI 辅助用例生成、定时任务调度、测试结果统计等能力。

一、接口自动化测试

1.1 功能概述

接口自动化测试模块支持完整的 HTTP 接口测试生命周期：

• 用例管理（增删改查、批量操作）
• 参数动态替换（变量提取与注入）
• cURL 命令导入用例
• Apifox 规范导入
• 定时执行计划（Cron 调度）
• 执行结果记录与统计

1.2 核心模块

1.2.1 用例管理

页面入口： 侧边栏 → 接口测试 → 用例列表（/case）

功能列表：

1.2.2 用例编辑（新增/修改）

页面入口： 用例列表 → 新增用例（/caseadd）

编辑器分区：

cURL 导入

在「cURL 解析」区域粘贴 cURL 命令，点击解析按钮，自动填充：请求方法、URL、Headers、请求体。

参数后置处理（变量提取）

在「后置处理」标签页配置提取规则，格式：变量名_JSONPath表达式。

示例：

• 提取 Token：token_$.data.token
• 提取用户 ID：userId_$.data.id

提取的变量可在后续用例的 Headers / 请求体中通过 _${变量名} 引用。

实时执行与结果预览

右侧面板实时展示：

• HTTP 状态码（绿色=成功，红色=失败）
• 执行耗时（毫秒）
• 响应 Body（JSON 树状查看器）
• 响应 Headers

1.2.3 参数替换键（变量管理）

后端接口： /replacekey

用于管理全局变量，实现用例间数据传递。

1.2.4 测试计划（定时调度）

页面入口： 侧边栏 → 接口测试 → 计划列表（/planview）

功能：

计划字段说明：

后端接口：

1.2.5 执行结果查询

页面入口： 侧边栏 → 接口测试 → 执行结果（/caseresult）

筛选条件：

• 用例 ID
• 计划 ID
• 执行结果（成功/失败）
• 最近 N 条

结果字段：

后端接口：

1.2.6 工具接口

1.2.7 接口执行

1.3 接口自动化整体流程

1. 新建用例
   ├── 手动填写（URL / Method / Headers / Body）
   ├── 粘贴 cURL 自动解析
   └── Apifox 导入

2. 配置断言
   ├── 一级断言（JSONPath 表达式）
   └── 二级断言

3. 配置变量提取（后置处理）
   └── 提取响应值 → 供后续用例引用

4. 手动执行 / 加入测试计划

5. 查看执行结果
   └── 支持历史查询 + 数据统计

二、UI 自动化测试

2.1 功能概述

UI 自动化测试模块基于 Playwright（Java） 实现，支持 H5 / Android / iOS 三端，提供：

• 测试用例管理（步骤级编排）
• 页面信息管理（被测页面注册）
• 元素选择器管理（复用元素库）
• AI 辅助解析 HTML 提取元素
• AI 自然语言生成测试用例
• 定时执行计划
• 执行结果与截图查看

2.2 核心模块

2.2.1 被测页面管理

页面入口： 侧边栏 → UI 自动化 → 页面管理（/uitestpagemanage）

在执行 UI 测试前，需要先注册被测页面（URL）。

字段说明：

后端接口：

2.2.2 元素选择器管理

页面入口： 侧边栏 → UI 自动化 → 元素管理（/uiselectormanage）

为每个页面定义可复用的 UI 元素定位信息。

字段说明：

后端接口：

2.2.3 AI 解析 HTML 提取元素

页面入口： 侧边栏 → UI 自动化 → AI 导入元素（/uiselectoraimport）

使用步骤：

1. 在「关联页面」下拉框选择目标页面
2. 在文本框中粘贴页面 HTML 源码（最大 200KB）
3. 点击「AI 解析」
4. 系统自动识别页面中的可交互元素（按钮、输入框、链接等），生成元素名称和定位表达式
5. 以表格或 JSON 格式预览结果
6. 确认后保存到元素库

2.2.4 UI 测试用例管理

页面入口： 侧边栏 → UI 自动化 → 用例列表（/uitestcaselist）

用例列表操作：

后端接口：

2.2.5 用例步骤编辑

页面入口： 用例列表 → 新增用例 / 编辑（/uitestcaseadd）

基础信息：

步骤配置（每条步骤）：

步骤管理操作：

• 在任意步骤前/后插入新步骤
• 删除步骤
• 拖拽调整顺序（序号字段）

2.2.6 AI 生成测试用例

页面入口： 侧边栏 → UI 自动化 → AI 生成用例（/uitestcaseaigenerate）

使用步骤：

1. 选择关联的接口测试用例（可选）
2. 选择涉及的页面（多选，从页面库中选取）
3. 用自然语言描述测试场景，如：测试用户输入正确的用户名和密码后能成功登录
4. 点击「AI 生成」
5. 系统结合页面元素信息，自动生成完整步骤列表（包含操作类型、元素、操作值）
6. 确认后保存为测试用例

后端接口： POST /ui-auto-test-case/parseByAi

2.2.7 测试执行

后端接口：

执行引擎基于 Playwright Java 1.54，默认使用 Chromium 浏览器。

浏览器安装状态检查：

# 检查安装状态
curl http://localhost:8080/api/playwright/status

# 重新安装
curl -X POST http://localhost:8080/api/playwright/reinstall

2.2.8 执行结果查询

页面入口： 侧边栏 → UI 自动化 → 执行结果（/uitestresult）

筛选条件：

• 用例 ID
• 执行结果（成功/失败）
• 执行次数
• 计划 ID

结果展示：

展开后查看步骤详情：

后端接口：

2.2.9 综合测试计划（接口 + UI）

后端接口： /all-test-plan

用于将接口测试和 UI 测试统一到一个计划中执行。

2.3 UI 自动化整体流程

1. 注册被测页面
   └── 维护页面名称 + URL

2. 注册页面元素
   ├── 手动新增（填写元素名称 + CSS/XPath）
   └── AI 解析 HTML 批量导入

3. 编写测试用例（步骤编排）
   ├── 手动编排步骤（选择元素 + 操作类型 + 操作值）
   └── AI 自然语言生成步骤

4. 执行测试
   ├── 手动触发（按用例 ID 执行）
   └── 加入综合计划（定时执行）

5. 查看执行结果
   └── 用例结果 + 步骤日志 + 截图

三、系统架构与技术说明

3.1 后端技术栈

3.2 前端技术栈

3.3 数据模型关键字段说明

接口测试用例（Case）

UI 测试步骤（UiTestStep）

四、用户认证

页面： /login

支持两种登录方式：

登录成功后 Token 与用户信息存储到 localStorage，路由守卫自动检查 Token 有效性，未登录跳转至登录页。

五、常见问题

Q1：Playwright 浏览器启动失败

Cannot run program "/tmp/playwright-java-xxx/node"

解决：

mvn exec:java -e -Dexec.mainClass=com.microsoft.playwright.CLI -Dexec.args="install chromium"

确保磁盘剩余空间 >= 500MB，且网络可访问 Playwright 官方资源。

Q2：前端请求 404 / 跨域

检查 .env 文件中 VUE_APP_SERVER_URL 是否与后端地址一致（vue.config.js 中已配置代理）。

Q3：定时任务不执行

1. 确认计划状态为「运行中」（status=1）
2. 检查 Cron 表达式格式是否正确（可用在线 Cron 验证工具）
3. 查看后端日志中 Quartz 相关错误

Q4：AI 功能无响应

AI 功能依赖配置中心（Apollo）注入的 AI 服务密钥（AiChatProperties），请确认：

1. Apollo 连接正常
2. AI 服务 Key 已配置到对应 namespace

文档生成时间：2026-03-03