基于AI进行web界面自动化测试

啦啦啦!

503人浏览 · 2026-07-18 19:15:33

啦啦啦! · 2026-07-18 19:15:33 发布

一.项目背景

随着数字化的不断推进，问卷系统已成为企业、学术机构收集用户反馈、进行市场调研的核心工具。系统的 Web 界面功能日益丰富，涵盖了问卷创建、题目编辑、逻辑跳转、数据导出等多个模块，交互复杂度持续提升。

传统的测试方式依赖于测试人员手动编写测试脚本，不仅编写和维护成本高，而且难以覆盖各种边界条件和异常场景。随着迭代加速，回归测试的工作量呈指数级增长，单纯依靠人力已无法满足快速交付与高质量保障的双重要求。

为解决这一痛点，本项目引入 Web 界面 UI 自动化测试 方案，实现对问卷系统核心流程的无人值守回归。更进一步，借助大语言模型的能力，测试脚本的生成、维护、执行与结果分析全部由 AI 接管：测试人员只需用自然语言描述测试意图，AI 即可自动完成用例设计、脚本生成、截图比对和报告输出，真正实现从“写脚本”到“管流程”的转变，显著提升测试效率与覆盖度。

本系列文章将围绕以下维度展开：

UI 自动化测试的架构设计与技术选型；
AI 驱动测试用例生成与维护的实践；
全流程自动化的集成方案与落地经验。

二.准备工作：

我们这里是基于codex来实现的，我们前期的准备工作就是生成一个规定AI整体思路的文档

要求其根据文档一个整体的思路来进行实现和操作

模型使用的是最新的5.6 Sol

这里codex还是十分强大的直接操控电脑预览了页面，然后把所有页面都简单过了一下，然后基于

这个项目来生成一些要求和输出文档

这是他生成的第一版说实话我有点不满意，让其进行修改，这是根据我的提示词修改的第二版：

最终版本：

这个版本基本符合我的需求，虽然还有些小瑕疵，但是也够用了。

三.阶段 1：文档与工程骨架

我看了下，他没按照建议的生成目录结构，让他生成好目录结构：

打开vscode看，更加直观：

可以看到这里已经完全生成好了，可以提交了

后面我进行的时候还是觉得不满意，感觉整个流程还是很乱，我删除仓库，并重启对话重新开始

现在使用计划模式，并且提示词让其去调用使用浏览器的skills这样方便其更好的看到需要进行哪

些方面的测试：

让他反问我的问题这样可以达到更好的效果

问题1：

直接使用的推荐回答

这个肯定选1，因为这样才能模拟注册

还有两个问题：

选1，越深越好

继续选1

第一版生成的计划：

继续问的问题：

这里直接选3：

问了这么多问题，终于可以开始了，这样的方式AI还是比较谨慎的

开始完成列举的TODO清单了

他这里执行冒烟的时候其实也发现了我自己进行自动化测试的时候的错误，就是有个页面会超时

响应很久才有反应

我看到执行了很久，居然这里自己来跑所有任务，千万注意，不能这样，不然会把上下文撑满

这里看到他执行的一些用例算是比较基础的，就是大框架的用例而不是去细分的，所以SPEC.md

也就是要求已经规定好了后，我们直接可以进入到vscode中借助

目前看到AI直接准备一把梭哈的时候已经快完成了第一阶段，所以这里进行自检然后完成第二阶段

四.阶段 2：公共基础能力

遇到的问题：无头模式：

这里是因为我执行pytest时没有看到弹出对应的浏览器操作，所以这里我问了一嘴，延申出了这个

问题

需要观察操作过程时，用有头模式执行：

python -m pytest --headed -s

例如只运行登录模块：

python -m pytest tests/test_02_login.py --headed -s

或运行单个用例：

python -m pytest tests/test_02_login.py::test_用例名称 --headed -s

最推荐的调试命令是：

python -m pytest tests/test_02_login.py --headed -s -vv

这里我直接修改了文件改成了有头模式：

如果后续想换成后台运行，可以直接改成ture即可

还补充了驱动管理放在哪里的，检查了下：

五.阶段3：注册：

提示词

[SPEC.md](SPEC.md) 根据要求完成阶段3-注册，先在此用例的基础上，去完善 [测试用例.md](测试用例.md) 的注册部分，先别急着写代码，完善测试用例的时候按照当前格式，并且先列一个大纲我看看哪些测试用例符合要求再去修改源文件

阶段 3 主要完成内容

本阶段围绕“注册”模块完成了文档、页面对象、数据驱动、自动化测试和账号初始化流程：

完善注册用例文档，覆盖 REG-001 至 REG-010
根据真实页面规则补充注册数据 YAML
完善 RegisterPage 页面对象：
- 表单字段识别
- 字段级校验提示
- 密码长度校验
- 重复账号提示
- 返回登录页面
实现注册成功、登录验证和账号持久化
增加运行时账号文件防覆盖机制
增加 --force-account-init 显式强制初始化参数
修改初始化脚本，先执行校验用例，再执行账号初始化
增加账号信息和 Allure 页面源码的密码脱敏
更新 README 和 pytest 标记

测试过程中发现的 BUG

1. 用户名约束的预期与实际页面不一致

最初用例假设用户名存在最小长度、最大长度或字符格式限制。

实际检查页面后发现：

用户名没有 minlength
没有 maxlength
没有 pattern
只有非空校验

修复方式：

将用例调整为“用户名前端输入约束检查”
自动化验证页面实际声明的约束属性为空
不再臆测用户名长度或格式规则

2. Selenium 没有捕获重复账号提示

重复用户名提交后，页面实际显示的是：

账号已存在

但它不是普通的 .ant-message-notice-content 消息，而是页面顶部的：

.ant-alert-message

修复方式：

将页面对象的结果提示定位器扩展为：

.ant-message-notice-content, .ant-alert-message

同时兼容普通消息提示和页面级错误提示

3. 页面属性缺失时 Selenium 返回空字符串

用户名没有 pattern 属性时，Selenium 返回的是空字符串 ""，而 YAML 预期是 null。

修复方式：

element.get_attribute("pattern") or None

对 minlength、maxlength、pattern 统一进行空值归一化，最终返回 None。

4. 账号文件可能被重复覆盖

原来的 save_account() 直接以写入模式打开 runtime_account.yaml，存在误覆盖长期测试账号的风险。

修复方式：

默认禁止覆盖已有账号文件
文件存在时抛出中文 AccountStoreError
只有显式传入 overwrite=True 时才允许覆盖
初始化脚本增加 -Force 参数，用于明确执行账号替换

5. 注册成功和登录验证存在执行顺序依赖

原有文档将“注册成功”和“注册账号可登录”拆成两个依赖前一个用例的测试，可能违反 pytest 不依赖文件顺序的要求。

修复方式：

合并为完整的首次账号初始化流程：
1. 生成唯一用户名
2. 注册
3. 登录验证
4. 保存 runtime_account.yaml
5. 验证账号文件内容

6. 敏感密码可能出现在失败产物中

检查失败输出时发现：

pytest 失败参数可能直接展示账号字典中的密码
Allure 页面源码可能包含密码输入框的 value

修复方式：

新增 RuntimeAccount，重写 repr()，只显示脱敏密码
新增 sanitize_page_source()，对密码输入框的 value 替换为 ***
Allure 附加页面源码前先执行脱敏

测试结果

最终验证结果：

阶段 1、阶段 2 基础测试：24 passed
注册模块全量测试：12 passed, 1 skipped
初始化脚本：
- 校验阶段：12 passed
- 初始化阶段：因已有运行时账号，按账号长期复用策略跳过
config/runtime_account.yaml 未被普通测试覆盖

本阶段最终实现了注册模块从用例设计、页面操作、异常校验，到首次账号初始化和安全持久化的完整流程。

问题：我自己写的时候没有将页面代码和测试代码分开：

还有个问题他把阶段测试也加在阶段测试中了，提示词：

我我想最终在终端输入命令pytest的时候不去执行阶段性的基础测试，这个在阶段结束的时候不是已经执行过了吗，不需要重复啊

这里pytest的默认配置时会把那个阶段性测试加上去，如果后续后面自己执行pytest的时候

会把那个阶段性测试加上去，因为阶段性测试会在每个阶段已经跑完了，那么后续不需要执行了

只要把要求加在SPEC.md中，执行阶段性测试的时候自己去执行，这样阶段性测试不会浪费时间

自己整体执行业务测试的时候也不会浪费时间

六.阶段4：登录：

这是他补充的用例，还可以，可以让他写入到测试用例.md中去了

这里也是非常严谨啊，修复了问题全部重新跑了一遍，也是消耗了不少时间：

在这个修改和思考的过程中我们发现其实他也遇到了些问题这里我们让他总结在这个阶段发现

了哪些问题：

问题：

主要遇到 4 个问题，都是在跑真实登录页面时暴露出来的。

conftest.py 里登录失败终止逻辑一开始写错了语法
我原本写成了：

pytest.fail("已保存账号登录失败，终止业务测试；不会自动注册新账号") from exc

pytest.fail() 是函数调用，不能接 from exc，所以 pytest 加载 conftest.py 时直接语法错误。
解决方式：改成显式抛 AssertionError，保留异常链：

raise AssertionError("已保存账号登录失败，终止业务测试；不会自动注册新账号") from exc

登录后刷新页面，侧栏容器出现了，但菜单文本还没加载完
LOGIN-009 第一次失败时，aside 已经存在，但 aside.text 是空字符串，导致断言菜单缺失。

原因是原来的 LayoutPage.wait_loaded() 只等侧栏元素可见，没有等菜单内容渲染完成。
解决方式：把等待条件改成“侧栏可见且文本非空”，再读取菜单文本：

self.wait(
    lambda driver: self._visible_side_menu_text(driver),
    "等待侧栏菜单加载完成",
)

这样刷新后不会太早断言。

已登录状态访问登录页，系统不会自动跳回 /home
我最初按测试用例预期理解为：已登录后打开 /user/login 应该自动跳首页。真实站点不是这样，它会停留在登录页，但登录态没有丢。

解决方式：把该用例调整成更贴近真实行为：
已登录后打开登录页，再访问受保护页面 /home，验证不需要重新登录，菜单和账号状态仍正常。也同步更新了 测试用例.md 的 LOGIN-011 预期描述。

页面上没找到明显“退出登录”入口
我尝试点击右上角设置、头像、下拉触发器等，但真实 DOM 和可见文本里没有稳定的“退出/退出登录”入口。页面登录态实际保存在：
- localStorage.Authorization
- Cookie：sk-token
- 部分 sessionStorage

解决方式：LayoutPage.logout() 先尝试点击 UI 上的“退出/退出登录”；如果找不到，就清理登录态作为兜底退出：

localStorage.removeItem('Authorization')
sessionStorage.clear()
driver.delete_all_cookies()
driver.get("/user/login")

然后再访问受保护页面，验证确实回到登录页。

另外还有一个小稳定性问题：LOGIN-001 登录页控件检查在注册+登录联跑时偶发失败，因为 core_controls_visible() 原来用的是短等待。后来改成完整显式等待，联跑就稳定通过了。

这里第四点他其实说错了我们这个是有退出功能的只不过要点击展开页才能看到所以纠正一下：

他之前其实跑这个用例的时候为了过而过，做了登录状态清除的兜底，所以这是很不合理的

这里要纠正，其实是有这个元素的，这里还是非常严谨每次修改完他都会检测有没有影响到

整个项目的跑通

我在这里还问了他关于元素定位他如何去定位的;

七.阶段5：普通业务模块：

这里涉及到的页面比较多：

1.我的项目页面（有问题）：

这里涉及到的主要问题是AI偷懒了有三个测试用例没有完成，我让其完成的时候也出现了问题

就是选择进入回收站时，出现了一个确认弹窗，但是他思考了却没有发现这个弹窗，导致思考跑

偏，我看他在自动化运行测试用例的时候发现他根本没有处理好这个弹窗所以导致失败很多次

所以这里及时进行了纠正

这里他完成了写入，但是还有一点不足的是，我刚看了我的项目的测试用例

比如说这里，其实他没有主要到的是这里会跟设置按钮是一样的，会进行展开选择：

这里提示他补充一下：

这里我让他自己操控浏览器来进行实际的体验看看如何进行测试用例的编写

注意到这里居然还有未实现的，偷懒了：

他这里出现了一个致命问题就是点击删除时其实有一个弹窗导致元素没有定位到，导致一直在更改

和思考，直到我看到他的自动化的过程的时候发现其实他并没有点击到这个确定按钮

这里我看到他思考的方向已经偏离了，要及时纠正了

这里我确实说的也没错，我看他自动化的过程就看出来了他没有定位到确认按钮，并且没有处理

总结本阶段遇到的问题：

2.我的练习页面（有问题）P0：

这里因为是新账号，没有我的练习的数据，而我的练习需要去我的题库-新建：

这里必须要开启添加到我的练习题库才能在我的练习看到数据

而这里他因为没有我的练习的数据导致很多用例直接跳过：

所以这里要跟他说一下

要先在我的题库页面创建好题库：

然后点击新建注意这里告诉他必须选上这个添加到练习题库：

这样才能在我的练习页面看到，后面他思考了很久一直在我的练习页面重复等待题库出现导致一直

循环在执行那个测试用例，所以我观察后立即中断：

后面更新好后发现另一个问题他创建完我的题库后，进入我的练习，然后又跳到了我的题库

然后一直在等他创建的那条题库实则他创建的那条题库已经被挤到后面了需要点击下一页才能

找到所有又在循环执行操作，这里又中断然后进行提醒：

后面在我的练习页面点击开始练习出现了个弹窗他又进行了循环等待导致错误这里又中断然后重新

告诉他怎么了

这里我看他自动化跑的过程中一直卡在这个弹窗：

导致他一直卡在这个页面，这里要重开一个对话了简单说明问题并修复

这里我觉得的修复方案就是删除这4个测试用例因为我的题库页面创建时没有真实创建题目

导致其实进入到我的练习页面并没有题目可供练习

所有这里直接验证可以进入我的练习页面即可

后面可以优化下等我的题库创建完调换个执行顺序，让其真正能跑后面的测试用例

3.我的题库页面：

我们记得再每开始一个模块的时候，记得看那个模块的测试用例是否符合我们的要求，我们可以

检查一下再去实现：

用例质量还可以，可以让其进行实现

这一次我全程没有干预观察其完成效果：

感觉他这里遇到的问题还是比较多的，等会来让他总结一下遇到了哪些问题，又是如何进行修复的

遇到的问题1：

补充问题：就是我的题库可以命名两个同时存在的题库：

遇到的问题2：

我看测试用例中我的练习和我的题库页面的测试状态仅仅是已实现而不是已通过，这样代表他

可以只是实现了代码而并没有跑通整个流程现在让他重新跑并修改状态：

这里因为他排查问题的时间会有点久我这里直接给他一个流程操作，引导一下这样就完成了任务

4.补充说明：

这里问题管理和我的笔记就涉及到了我的题库和我的练习的链路，因为这里不涉及那么复杂的操作

如果感兴趣，你们可以作为拓展实现，我这里相当于只对主流程进行了自动化测试

这里如果要实现的话就要先补充我的题库进行题目的创建还不能仅仅只是创建空题库，还要必须

创建一个有题目的题库那么这样的话涉及到的测试用例又有很多，所有有些复杂并且你创建完

有题目的题库，还必须要进行练习，不进行练习的话是没有问题管理和我的笔记的，所以这里

我并没有实现的这么复杂，只做了简单的主流程感兴趣的话可以进行拓展和优化

5.模板广场

单独执行某一模块的命令：

注意：

提示词：

[SPEC.md](SPEC.md) [测试用例.md](测试用例.md) 根据要求和测试用例完成模板广场部分的自动化代码的编写
这里注意以下问题
1.选择一个可用分类进行筛选时这里有公共库和私有库，区分这个的话是要在添加模板时，勾选是否添加到公共库如果不勾选你要先点击私有库才能看到你创建的分类我的建议是调整一下测试用例的顺序和实现顺序先把创建模板放到首位这样下面的测试用例才能更好的实现
2.添加模板的话在模板广场首页的有添加模板的按钮点击会跳转到添加模板的详情页面这里添加模板的话不做其他复杂的操作等待加载完毕后直接点击保存会弹出**保存到问卷模板库的弹窗如图一这里还要点击保存点击完保存后其不会自动跳转到模板广场首页，这里你要自行去点击关闭按钮才会返回到模板广场首页**
3.预览弹窗的话是把鼠标定位到你刚刚创建的模板上然后下面会出现导航栏第三个像电脑图标的那个移动到上面会出现预览模板的提示点击才能完成预览操作
4.你删除模板的测试用例的步骤写的有问题不用去跳转到我的项目页面也是在模板广场首页鼠标定位到你刚刚创建的模板上然后下面会出现导航栏第一个就是删除点击删除后还会有确认弹窗
5.注意一定要把创建模板放到首位，整个自动化流程中使用你创建的那一个模板并记录名称后续都是用它正好最好一个测试用例是删除创建的模板
根据上面的注意点先修改测试用例再执行

这里我不让他直接进行自动化测试代码的编写因为我看了测试用例和真正进入到网页进行操作

发现很多不一样的点然后对其进行补充和修改

现在这样详细描述的他的效果还是比之前直接进行代码的实现操作要准确不少

这里总结一下几个问题：

问题1：这里我告诉点击添加模板后是弹窗一个新的页面

这里AI以为是更换了baseURL他根据baseurl来等待页面处理的出现然后定位保存按钮，实际上点

完添加模板直接弹出了个编辑器并且有切换页面也就是baseburl并没有切换

导致这里他并没有定位到保存按钮，导致失败

这里引导了一下就成功解决了实际上并没有切换页面他这里却一直等待新页面出现导致失败

问题2：填写分类时没有定位到分类输入框就直接输入导致添加模板用例执行失败

问题3（最严重）：无法搜索到已经保存的模板

这里我让AI去重新执行然后去搜索，他一开始找出的问题是：

他觉得的问题可能是后端做了校验就是如果模板里面没有东西是搜索不到的然后我这自行手动去

创建了一个有内容的模板还是搜索不到然后我就及时打断觉得这里是网站的原因

然后这里让他重新调整并告诉他我的决策就是删除涉及到根据模板名称搜索的这个测试用例

之前他校验创建成功模板时他也是想根据是否搜索的到来完成但是其实这里这个功能是错误的

导致执行一直卡在这里然后失败，这里正好创建成功会有一个提示，模板创建成功的提示弹窗

我让他根据这个来校验模板创建成功

这里总结了几点网站为什么会发生这种情况的BUG：

我会按概率这样判断：

保存接口返回成功，但数据没有真正写入数据库
后端可能先返回成功消息，但事务失败、异常被吞掉，或者保存的是临时编辑数据而不是模板记录。
保存成功，但模板关联的用户/租户 ID 不正确
私有库查询通常会按当前用户过滤。如果保存时没有正确写入 user_id、owner_id 或租户字段，创建接口能成功，查询接口却永远查不到。
保存接口和查询接口使用了不同的数据表或状态字段
例如保存写入“问卷模板表”，查询只查“已发布模板表”；或者保存状态是 draft，查询只筛选 published/active。
私有库查询接口的参数或权限条件错误
比如前端传了错误的 libraryType、用户身份参数，或者后端把私有库错误地按公共库逻辑查询。
保存成功提示只是前端乐观提示
前端可能在请求发出后就弹出“保存成功”，没有根据真实后端响应判断。请求实际可能返回 4xx/5xx，但错误没有展示出来。
查询接口本身有问题
搜索关键词可能没有正确传给后端，或者接口固定返回空数组。可以通过不输入关键词、切换公共库/私有库来验证。

这个阶段结束结束后我pytest执行了一下以上所有的测试用例：

这个21deselected是没有被选中的意思因为他是阶段性测试已经测阶段1和阶段2已经完成测试了

没有必要再进行测试从而浪费时间

八.阶段6：系统管理模块

因为组织机构需要管理员才能进行编辑那么我们没有管理员权限所以这里只能进行普通账户的流

程测试那么这里直接去掉有关组织机构的代码和测试用例

1.岗位设置：

这里的测试用例有问题应该先执行新建岗位再去查询然后再去修改相关的数据，还有使用重复

编码不会报错纠正一下

问题：下拉框没有定位到导致创建失败（实际上是因为编码过长导致失败页面也没有给出提示）：

这里提示词写的很清楚了不懂为什么还是定位不到这个元素：

我这里重开一个对话来让其进行修复

这里他一直修复不好我想的是就把他弄的文本填入进去我自己点击试一试发现是岗位编码过长

导致点击了也没有效果这个页面居然没有做提示导致测试用例失败一直卡在这块

问题2：由于创建的岗位过多点击确认后没有看到那个岗位是因为在分页的后面

问题三：担心分页过多执行了删除操作

但这里他为了避免分页过多又自行加上了删除逻辑完全没有必要这里告诉他让他重新修复

问题四：这里要做一个修改就是后续的操作只读创建时所生成的岗位

这次岗位设置主要遇到了以下问题：

测试数据没有串联
- 每个用例都重新生成岗位名称。
- 编辑、删除无法复用创建用例生成的岗位。
- 现在通过 config/runtime_position.yaml 保存岗位名称、编码和权限，后续用例统一读取；删除成功后清理该文件。
编辑逻辑改错字段
- 原编辑用例修改的是岗位名称。
- 已调整为保持岗位名称和数据权限不变，只修改岗位编码。
- 新编码缩短为 POS_ 加 6 位随机字符，避免页面长度校验导致保存失败。
删除确认弹窗没有等待
- 原逻辑直接查找并点击确定按钮，弹窗还未加载时会定位失败。
- 现在会等待包含“删除”和“确定”的可见弹窗，再定位弹窗内部确定按钮，点击后继续等待弹窗关闭。
岗位名称过长时列表显示省略号
- Selenium 的 row.text 只能拿到截断后的名称，导致明明存在岗位却判断为不存在。
- 现在同时读取单元格的 title 和 textContent，可以匹配完整名称。
Ant Design 受控输入框清空异常
- 查询框使用 clear() 后再输入时，旧值可能没有同步清除，导致新旧名称拼接。
- 现在优先使用 Ctrl+A 后输入，确保 React 表单状态同步。
编辑抽屉编码输入框不可直接交互
- 编码输入框在页面布局中有时被压缩，Selenium 直接 clear() 会报 ElementNotInteractableException。
- 已增加原生输入值设置及 input/change/blur 事件触发逻辑。
编辑抽屉确定按钮位于表单外
- 新建和编辑抽屉的按钮结构不完全一致，编辑按钮位于抽屉页脚。
- 提交逻辑现在会同时查找表单内按钮和抽屉/模态页脚按钮。
重复编码用例误删主岗位
- 重复编码用例清理第二个岗位时，之前也可能把后续用例需要的主岗位删掉。
- 现在只删除重复创建的第二个岗位，保留主岗位直到最终删除用例处理。

本地基础测试、岗位关键用例以及你重新执行的完整岗位模块测试均已通过。

后面我又运行时还有错误又进行了修复：

这次岗位设置问题主要集中在“测试数据串联、页面异步渲染、Ant Design DOM 结构差异”三个方面。

1. 创建后的岗位没有被后续用例复用

原因：每个测试都用 unique_value() 生成新的岗位名称，创建、查询、编辑、删除之间没有共享数据。

修复：

新增 utils/position_store.py。
创建成功后写入 config/runtime_position.yaml。
查询、编辑、重复编码、删除用例优先读取这份数据。
删除成功后清理运行时岗位文件。
单独运行后续用例时，如果运行时数据不存在，会自动补建岗位。

2. 编辑用例修改了错误字段

原因：原来的 edit_position() 修改的是岗位名称，和实际需求不符。

修复：

编辑时保持岗位名称不变。
只修改岗位编码。
数据权限也保持原值不变。
新编码缩短为 POS_ 加 6 位随机字符，总长度为 10 位，避免页面长度校验失败。

3. 删除确认弹窗定位不稳定

原因：删除弹窗是异步加载的，并且通常通过 Portal 挂载到页面外层。原逻辑立即查找“确定”按钮，弹窗尚未出现时就会定位失败。

修复：

等待包含“删除”和“确定”的可见弹窗出现。
在弹窗内部查找“确定”按钮。
点击后继续等待弹窗关闭。
增加 ant-btn-primary 作为按钮定位兜底。

4. 长岗位名称导致“岗位不存在”误判

原因：表格名称列使用了省略号，Selenium 的 row.text 只能拿到页面上显示的截断文本，而不是完整名称。

修复：

同时读取表格单元格的 title 和 textContent。
表格重绘期间 Selenium 暂时获取不到行时，再通过 JavaScript 从当前 DOM 查询完整名称。
position_visible() 在已经找到匹配行时直接返回成功，减少重复查询造成的时序问题。

5. 查询框出现旧值和新值拼接

原因：Ant Design 的查询框是 React 受控组件，直接执行 clear() 后再 send_keys()，原生输入框的值清除了，但 React 状态没有同步更新，重新渲染时旧值又被恢复。

修复：

对可交互输入框使用 Ctrl+A 后输入。
对不可交互输入框使用原生 value setter，并触发 input/change/blur 事件，让 React 状态同步。

6. 编辑抽屉的编码输入框不可直接操作

原因：编辑抽屉中的编码输入框在某些窗口布局下被压缩，虽然存在于 DOM 中，但实际尺寸不可交互，直接 clear() 会触发 ElementNotInteractableException。

修复：

优先使用真实键盘输入。
输入框不可交互时，使用 JavaScript 原生 setter 更新值，并触发输入事件。

7. 编辑抽屉的确定按钮不在表单内部

原因：新建抽屉和编辑抽屉的 DOM 结构不同。编辑页面的“确定”按钮位于 .ant-drawer-footer，是表单的兄弟节点，不能只在表单内部查找按钮。

修复：

先查找表单内部按钮。
找不到时查找抽屉或模态框页脚按钮。
最后再按按钮文本“确定”进行全局兜底定位。

8. 重复编码用例误删主岗位

原因：重复编码用例清理时曾经把第二个岗位和主岗位都删除，导致后面的删除用例找不到创建用的岗位。

修复：

重复编码用例只删除第二个岗位。
主岗位一直保留到最终删除用例。

9. 配置文件拼写错误

原因：config/config.yaml 中曾出现：

headless: ture

配置解析会把未知字符串当成 false，导致实际使用有头浏览器。

修复为：

headless: true

最终验证结果：

岗位模块：6 passed
基础阶段：20 passed

这些问题本质上是测试状态共享、React 受控组件、Ant Design 异步渲染和虚拟表格文本截断共同造成的。

2.个人设置：

九.最终验收并生成测试报告：

Allure 报告完整执行步骤

在项目根目录依次执行：

1. 执行测试并生成 Allure 原始数据

python -m pytest --clean-alluredir

原始数据生成在：

reports/allure-results

2. 生成 HTML 报告

allure generate reports/allure-results -o reports/allure-report --clean

HTML 报告生成在：

reports/allure-report

3. 启动本地服务器并打开报告

allure open reports/allure-report

浏览器会打开类似下面的地址：

http://127.0.0.1:端口号/

运行报告期间不要关闭这个 PowerShell 窗口。

完整命令汇总：

python -m pytest --clean-alluredir
allure generate reports/allure-results -o reports/allure-report --clean
allure open reports/allure-report

也可以省略“生成 HTML 报告”这一步，测试结束后直接临时启动报告服务器：

python -m pytest --clean-alluredir
allure serve reports/allure-results

十.总结：

整个的项目架构与流程

pytest + Selenium + Page Object + YAML 数据驱动 + Allure Web UI 自动化测试项目。

核心设计是把“测试数据、页面操作、测试逻辑、运行配置”拆开管理。

整体架构

执行脚本 scripts/
        │
        ▼
pytest.ini 选择测试范围、优先级
        │
        ▼
conftest.py 创建浏览器、准备账号和登录状态
        │
        ▼
tests/test_xxx.py 组织测试步骤和断言
        │
        ├──读取──▶ data/xxx.yaml
        │
        └──调用──▶ pages/xxx_page.py
                         │
                         ▼
                  Selenium 操作网页
                         │
                         ▼
                  实际系统页面

各目录职责

目录/文件	主要作用
`data/`	保存测试输入、预期结果、用例编号
`pages/`	封装页面元素定位和页面操作
`tests/`	编写真正的测试流程和断言
`utils/`	YAML、配置、日志、账号、随机数据等公共工具
`config/`	保存运行环境、浏览器配置和运行时数据
`scripts/`	提供冒烟、回归、报告生成等执行入口
`conftest.py`	pytest 公共 fixture 和失败处理
`pytest.ini`	pytest 的收集、标记、报告配置
`reports/`	Allure 测试结果和报告
`logs/`	自动化运行日志

YAML 文件是干什么的

项目中实际上存在三类 YAML。

1. 测试数据 YAML

例如 [exercise.yaml](D:/AI测试项目/AIweb自动化/data/exercise.yaml)：

cases:
  - case_id: EXERCISE-001
    title: 打开我的练习
    priority: P0
    enabled: true
    data: {}
    expected:
      path: "/exercise"
      menu: "我的练习"

主要字段：

case_id：测试用例唯一编号
title：用例名称
priority：业务优先级
enabled：是否加载这条用例
data：测试输入
expected：预期结果

测试文件通过 [yaml_loader.py](D:/AI测试项目/AIweb自动化/utils/yaml_loader.py) 读取：

CASES = {
    case["case_id"]: case
    for case in load_cases(root_path("data", "exercise.yaml"))
}

然后根据编号使用：

case = CASES["EXERCISE-001"]

assert case["expected"]["menu"] in page.menu_text()
assert case["expected"]["path"] in driver.current_url

所以你的理解是对的：data/*.yaml 用来提供测试数据和预期结果。

不过当前项目不是完全参数化的数据驱动。它采用的是：

测试代码主动根据 case_id 读取对应 YAML 数据。

也就是说，YAML 不会自动生成所有测试函数，而是为已有测试函数提供数据和预期值。

enabled: false 的用例会在加载阶段被过滤：

return [case for case in cases if case.get("enabled", True)]

2. 环境配置 YAML

[config.yaml](D:/AI测试项目/AIweb自动化/config/config.yaml) 保存运行配置：

base_url: "http://49.235.61.184:8080"

browser:
  name: "chrome"
  headless: true
  window_size: "1440,1000"

timeouts:
  explicit: 20
  page_load: 30

它控制：

测试网站地址
浏览器类型
是否无头运行
浏览器窗口尺寸
Selenium 等待时间
日志和报告目录

由 [config_loader.py](D:/AI测试项目/AIweb自动化/utils/config_loader.py) 读取。

环境变量可以覆盖其中部分配置，例如：

$env:TEST_BASE_URL = "http://其他地址"
$env:TEST_HEADLESS = "false"

3. 运行时 YAML

例如：

config/runtime_account.yaml
config/runtime_position.yaml

它们不是固定测试用例，而是保存自动化运行过程中产生的数据。

runtime_account.yaml 保存首次注册成功的账号，后续测试重复使用；runtime_position.yaml 保存自动化创建的岗位，供其他用例继续操作或清理。

pages 目录是干什么的

pages/ 使用的是 Page Object 页面对象模式。

它的核心思想是：

页面怎么操作，写在 Page 类里；测试要验证什么，写在 tests 里。

例如 [exercise_page.py](D:/AI测试项目/AIweb自动化/pages/exercise_page.py) 中定义：

NAME_INPUT = (By.CSS_SELECTOR, 'input#name')
QUERY_BUTTON = (By.XPATH, '//button[normalize-space()="查询"]')

以及页面动作：

def search_by_name(self, name: str) -> None:
    self.fill(self.NAME_INPUT, name)
    self.click(self.QUERY_BUTTON)
    self.wait_query_finished()

测试文件不需要知道输入框的 CSS、按钮 XPath，也不需要重复编写等待逻辑，只需要：

page.search_by_name(repository_name)
assert page.exercise_visible(repository_name)

这样网页定位器发生变化时，一般只修改 Page 文件，不需要修改所有测试。

Page 类继承关系

BasePage
   │
   ├── LoginPage
   ├── RegisterPage
   │
   └── LayoutPage
          │
          └── RoutePage
                 │
                 ├── ProjectPage
                 ├── ExercisePage
                 ├── RepositoryPage
                 ├── TemplatePage
                 ├── PositionPage
                 └── SettingPage

[base_page.py](D:/AI测试项目/AIweb自动化/pages/base_page.py) 提供最基础的 Selenium 能力：

打开页面
查找元素
点击元素
输入内容
显式等待
获取文本
等待 URL
截图

LayoutPage 增加登录后公共布局能力：

等待侧栏菜单
获取菜单文字
退出登录
清理登录状态

RoutePage 增加业务模块页面的公共能力：

打开并验证页面
获取表格表头
点击按钮
打开弹窗
按占位符搜索

具体的 ExercisePage、ProjectPage 再实现各自业务动作。

tests 目录是干什么的

tests/ 负责把下面三部分组合起来：

测试前置条件
Page Object 页面操作
测试断言

例如 [test_04_exercise.py](D:/AI测试项目/AIweb自动化/tests/test_04_exercise.py)：

def test_exercise_page_accessible(logged_in_driver):
    case = CASES["EXERCISE-001"]

    page = open_exercise_page(logged_in_driver)

    assert case["expected"]["menu"] in page.menu_text()
    assert case["expected"]["path"] in logged_in_driver.current_url
    assert page.core_area_visible()

其中：

logged_in_driver：由 conftest.py 提供
CASES：从 data/exercise.yaml 读取
ExercisePage：封装页面操作
assert：真正判断测试是否通过

这也是项目的职责边界：

YAML：输入什么、期望什么
Page：页面怎么操作
Test：执行什么步骤、验证什么结果

conftest.py 如何连接测试

[conftest.py](D:/AI测试项目/AIweb自动化/conftest.py) 是整个测试运行的公共入口。

driver fixture 每条测试创建一个 Chrome：

@pytest.fixture
def driver(request):
    web_driver = webdriver.Chrome(options=options)
    yield web_driver
    web_driver.quit()

registered_account 读取已经保存的测试账号：

@pytest.fixture(scope="session")
def registered_account():
    return load_account()

logged_in_driver 在测试开始前自动登录：

@pytest.fixture
def logged_in_driver(driver, registered_account):
    page = LoginPage(driver).open()
    page.login(
        registered_account["username"],
        registered_account["password"],
    )
    return driver

测试只要把 fixture 名写到参数里，pytest 就会自动执行：

def test_exercise_page_accessible(logged_in_driver):

调用过程是：

pytest 发现测试需要 logged_in_driver
        │
        ├──创建 driver
        ├──读取 registered_account
        ├──使用 LoginPage 登录
        ▼
把登录后的 driver 传给测试函数

一条练习测试的完整调用链

以 EXERCISE-001 为例：

run_smoke.ps1
    │
    ▼
pytest -m "smoke and not stage"
    │
    ▼
找到 test_exercise_page_accessible
    │
    ▼
conftest.py 创建 Chrome
    │
    ▼
读取 runtime_account.yaml
    │
    ▼
LoginPage.login() 完成登录
    │
    ▼
test_04_exercise.py 读取 EXERCISE-001
    │
    ▼
ExercisePage.open_and_verify()
    │
    ▼
BasePage.open() 打开 /exercise
    │
    ▼
Selenium 操作实际网页
    │
    ▼
测试根据 YAML expected 执行 assert
    │
    ├──通过：写入 Allure 结果
    └──失败：附加截图、URL、源码和错误摘要

scripts 和 pytest 标记

[pytest.ini](D:/AI测试项目/AIweb自动化/pytest.ini) 定义了两类标记。

按优先级：

p0：核心功能
p1：主要业务
p2：边界和异常

按用途或模块：

smoke
regression
login
project
exercise
repository
template
position
setting

[run_smoke.ps1](D:/AI测试项目/AIweb自动化/scripts/run_smoke.ps1) 执行：

python -m pytest -m "smoke and not stage"

只运行带 smoke 标记的核心测试。

[run_regression.ps1](D:/AI测试项目/AIweb自动化/scripts/run_regression.ps1) 依次执行：

P0 → P1 → P2

即使 P0 失败，也会继续运行 P1 和 P2，最后统一返回失败状态。

总结成一句话：

scripts 决定运行哪些测试，conftest.py 准备浏览器和账号，tests 组织业务流程，data 提供数据和预期结果，pages 负责操作页面，utils 提供公共基础能力，最后由 Allure 和日志记录执行结果。

天工造物局

北京人形旗下天工造物具身智能开源社区，聚焦具身天工与慧思开物两大平台

更多推荐

deck.gl TripsLayer 出租车轨迹动画示例实战：从示例运行到着色器原理

TripsLayer 是 deck.gl 中用于渲染**随时间流动的轨迹动画**（如出租车行程、物流路径、迁徙路线）的核心图层。本文以仓库中的最小独立示例 [examples/website/trips](https://link.gitcode.com/i/1442af8f442f4cff39ff546e050fceb5) 为骨架，带你完成从安装依赖、启动应用、理解曼哈顿出租车数据格式，到深入

天工造物局

Foundry Anvil 中 eth_simulateV1 的 Blob 交易与 Blob Gas 字段规范化：原理、实现与测试验证

本篇技术指南以 [anvil-simulate-blob-transactions.md](https://link.gitcode.com/i/3d2ebe227262de169335eb290af80da8) 这条 changelog 条目为起点，深入剖析 Foundry Anvil 对 `eth_simulateV1` RPC 返回结果中 blob（EIP-4844）交易与 blob gas

天工造物局

LMCache CLI 实战：用 `lmcache kvcache clear` 管理运行中服务的 KV Cache 状态

本文是一份针对 LMCache 官方 CLI 命令 `lmcache kvcache` 的完整技术指南。该命令用于在**运行中的 LMCache 服务（MP HTTP server）**上管理 KV cache 状态，当前提供 `clear` 子命令，用于清空 L1（CPU 内存）层中缓存的全部 KV 数据。读完本文，你将掌握该命令的完整参数体系、退出码语义、终端/JSON/静默三种输出模式，并能

天工造物局

所有评论(0)

查看更多评论

啦啦啦!

@2301_81154519

已为社区贡献2条内容

基于AI进行web界面自动化测试

啦啦啦!

一.项目背景

二.准备工作：

三.阶段 1：文档与工程骨架

四.阶段 2：公共基础能力

遇到的问题：无头模式：

五.阶段3：注册：

阶段 3 主要完成内容

测试过程中发现的 BUG

1. 用户名约束的预期与实际页面不一致

2. Selenium 没有捕获重复账号提示

3. 页面属性缺失时 Selenium 返回空字符串

4. 账号文件可能被重复覆盖

5. 注册成功和登录验证存在执行顺序依赖

6. 敏感密码可能出现在失败产物中

测试结果

问题：我自己写的时候没有将页面代码和测试代码分开：

六.阶段4：登录：

问题：

七.阶段5：普通业务模块：

1.我的项目页面（有问题）：

2.我的练习页面（有问题）P0：

3.我的题库页面：

遇到的问题1：

遇到的问题2：

4.补充说明：

5.模板广场

单独执行某一模块的命令：

注意：

问题1：这里我告诉点击添加模板后是弹窗一个新的页面

问题2：填写分类时没有定位到分类输入框就直接输入导致添加模板用例执行失败

问题3（最严重）：无法搜索到已经保存的模板

八.阶段6：系统管理模块

1.岗位设置：

问题：下拉框没有定位到导致创建失败（实际上是因为编码过长导致失败页面也没有给出提示）：

问题2：由于创建的岗位过多点击确认后没有看到那个岗位是因为在分页的后面

问题三：担心分页过多执行了删除操作

问题四：这里要做一个修改就是后续的操作只读创建时所生成的岗位

2.个人设置：

九.最终验收并生成测试报告：

Allure 报告完整执行步骤

1. 执行测试并生成 Allure 原始数据

2. 生成 HTML 报告

3. 启动本地服务器并打开报告

十.总结：

YAML 文件是干什么的

1. 测试数据 YAML

2. 环境配置 YAML

3. 运行时 YAML

pages 目录是干什么的

tests 目录是干什么的

conftest.py 如何连接测试

一条练习测试的完整调用链

scripts 和 pytest 标记

所有评论(0)

温馨提示：您尚未绑定手机号

啦啦啦!