自动化测试 / 系统课时
清理测试数据
清理测试数据
自动化测试只要会创建账号、订单、草稿或浏览器状态,就必须把“怎么清理”当成测试的一部分。本节给出可重复执行的清理边界、try/finally 实现方式和验收方法,目标是让同一用例连续运行时不受上一次残留影响。
学习目标
- 区分服务端业务数据、浏览器状态和共享基线数据的不同清理方式。
- 用唯一标识和
finally保证测试失败后仍执行清理。 - 在清理后再次查询或断言,确认数据确实恢复到预期状态。
先定义清理边界
清理最危险的错误不是“没删干净”,而是删除范围过大。测试创建的数据应带可识别的运行标记,例如账号 e2e-1042-user-01@example.test、订单外部号 E2E-1042-001。清理时按精确 ID 或本次运行前缀删除,不要使用“删除最近 100 条”这类与测试身份无关的条件。
| 数据类型 | 推荐标识 | 清理方式 | 验收条件 |
|---|---|---|---|
| 测试新建账号、订单 | 数据库 ID 或 e2e-<RUN_ID>- 前缀 |
测试专用 API、fixture 或受控后台接口 | 按 ID 查询不到,或返回 404 |
| Cookie、localStorage | 固定测试键名 | WebDriver Cookie API 或 execute_script |
对应键不存在 |
| 下载文件 | 每次运行独立目录 | 删除该运行目录 | 目录为空或已移除 |
| 共享基线配置 | 修改前保存旧值 | 测试结束恢复旧值 | 值与测试前一致 |

用 finally 保证失败后也清理
下面示例只依赖 Python、Selenium 和本机 Chrome。脚本启动一个临时 HTTP 页面,在页面 origin 下写入 localStorage,随后故意把清理放入 finally。即使测试主体中的断言改成失败,清理代码仍会执行;这正是服务端删除 API、回滚脚本或文件删除逻辑应采用的控制结构。
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
from threading import Thread
from selenium import webdriver
PAGE = b"<!doctype html><meta charset='utf-8'><title>cleanup demo</title>"
class Handler(BaseHTTPRequestHandler):
def log_message(self, format, *args):
pass
def do_GET(self):
self.send_response(200)
self.send_header("Content-Type", "text/html; charset=utf-8")
self.send_header("Content-Length", str(len(PAGE)))
self.end_headers()
self.wfile.write(PAGE)
server = ThreadingHTTPServer(("127.0.0.1", 0), Handler)
Thread(target=server.serve_forever, daemon=True).start()
driver = None
try:
driver = webdriver.Chrome()
driver.get(f"http://127.0.0.1:{server.server_address[1]}/")
# 测试主体创建一个只属于本用例的浏览器侧数据。
driver.execute_script(
"localStorage.setItem('e2e-record', 'created')"
)
value = driver.execute_script(
"return localStorage.getItem('e2e-record')"
)
assert value == "created"
print("during test:", value)
finally:
if driver is not None:
try:
# 清理必须放在 finally,而不是放在最后一个断言之后。
driver.execute_script(
"localStorage.removeItem('e2e-record')"
)
cleaned = driver.execute_script(
"return localStorage.getItem('e2e-record')"
)
assert cleaned is None
print("after cleanup:", cleaned)
finally:
driver.quit()
server.shutdown()预期输出:
during test: created
after cleanup: None安装 Selenium 可使用 python -m pip install selenium。示例中的 HTTP 端口由操作系统动态分配,实际值等价于 <PORT>;脚本不依赖固定端口。
服务端数据要按 ID 清理并再次查询
业务数据库里的账号、订单或文章不能靠 driver.quit() 清掉,因为关闭浏览器只结束浏览器会话。测试创建记录后应立即保存服务端返回的 ID,例如 user_id=58142;清理阶段按该 ID 删除,再做一次 GET 或数据库查询确认记录不存在。若系统采用软删除,则验收条件应检查 deleted_at 或业务状态,而不是假设物理记录消失。
一个常用顺序是:先删除依赖子记录,再删除父记录。例如订单含 3 条明细时,应由测试专用清理 API 根据订单 ID 处理整组关联数据,而不是让 Selenium 逐页点击删除按钮。除非“删除流程”本身就是被测功能,否则 UI 清理通常更慢,也更容易因元素状态变化而留下脏数据。
修改共享数据时恢复旧值
有些用例不能创建新对象,而是必须修改一条预置配置。此时不要在结束时写死“默认值”,而要在修改前先读取旧值。例如测试把 max_items 从当前的 25 改成 5,结束后应恢复读取到的 25;如果环境原值其实是 50,写死恢复为 25 会制造新的污染。
清理是否可靠可以用一个简单标准检查:同一用例连续运行 3 次,每次开始前都不需要人工处理,并且第 2、3 次的前置状态与第 1 次一致。达到这个条件,测试数据生命周期才真正闭合。