Selenium 如何测试表格?常见写法与 6 个坑(Python 示例)
后台管理系统里,表格是最常见、也最容易把自动化写「脆」的控件之一。
查询列表、点某一行的「编辑 / 删除 / 详情」、翻页后再断言数据——这些路径几乎每个团队都要测。用 Selenium 做 UI 自动化时,表格相关脚本往往占很大比重,也常常是 第一次能跑、改两次页面就全红 的重灾区。
本文用 Python + Selenium 4 说明几种常见写法,再集中讲 6 个坑。示例假设页面是常见的 HTML <table> 或 Ant Design Table;Element UI、iView 的思路类似,只是 DOM 结构不同,定位策略要跟着改。
一、先约定:表格测试通常要测什么
一条完整的「表格用例」,一般包含:
- 进入列表页(可能要先登录、先搜索)
- 等到表格数据加载完成
- 定位到目标行(按业务字段,如订单号、用户名)
- 对该行做操作(点击编辑、删除、勾选)
- 断言结果(弹窗、toast、行消失、字段变化)
下面代码都围绕这 5 步展开。
二、常见写法 1:按行内文本定位
最直觉的写法:找到包含某个关键字的行,再在该行里点按钮。
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
driver = webdriver.Chrome()
wait = WebDriverWait(driver, 10)
driver.get("https://example.com/orders")
# 等待表格至少有一行数据(不要只等 table 标签出现)
wait.until(EC.presence_of_element_located((By.CSS_SELECTOR, "table tbody tr")))
order_no = "ORD-20260319-001"
# 方式 A:XPath 找包含文本的行,再找行内「编辑」按钮
edit_btn = wait.until(EC.element_to_be_clickable((
By.XPATH,
f"//table//tr[.//td[contains(normalize-space(), '{order_no}')]]"
f"//button[contains(normalize-space(), '编辑')]"
)))
edit_btn.click()
适用: 原生 <table>,列文案相对稳定,行内按钮文案唯一(如「编辑」「删除」)。
注意:
- 用
normalize-space()避免前后空格导致匹配失败 - 订单号、用户名等尽量用 业务唯一字段,不要用「启用」「正常」这种多行重复的文案
- 用户输入拼进 XPath 时,若含引号要做转义;更稳妥是改用 CSS + 先筛行再 find
三、常见写法 2:先找行,再在行内 find
比一条超长 XPath 更好维护的写法:
def find_row_by_cell_text(driver, text: str):
rows = driver.find_elements(By.CSS_SELECTOR, "table tbody tr")
for row in rows:
if text in row.text:
return row
raise ValueError(f"未找到包含文本的行: {text}")
row = wait.until(lambda d: find_row_by_cell_text(d, order_no))
row.find_element(By.XPATH, ".//button[contains(., '编辑')]").click()
优点: 行定位逻辑可以抽成 helper,行内操作用相对路径 .//,改一处即可复用。
缺点: 行很多时遍历慢;虚拟滚动表格 DOM 里可能只有部分行,要配合滚动或搜索缩小范围。
四、常见写法 3:按行列索引(慎用)
# 第 2 行(tbody 下第 2 个 tr)、第 5 列点链接
cell = driver.find_element(By.CSS_SELECTOR, "table tbody tr:nth-child(2) td:nth-child(5) a")
cell.click()
只适合: 列顺序固定、几乎不会改列、且用例只验证「能点开第 N 行」的 smoke。
不要用于回归主路径: 产品加一列、调列顺序,脚本静默点错列,比直接报错更危险。
五、常见写法 4:Ant Design Table
很多后台不用原生 <table>,而是 Ant Design:
<div class="ant-table">
<div class="ant-table-container">
<table>...</table>
</div>
</div>
行内操作可能在「操作」列,或收进「更多」下拉:
# 等表格 loading 结束(Ant Design 常有 spin)
wait.until(EC.invisibility_of_element_located((By.CSS_SELECTOR, ".ant-spin-spinning")))
# 按单元格文本找行,点「删除」
row_xpath = (
f"//tr[contains(@class,'ant-table-row')]"
f"[.//td[contains(normalize-space(), '{order_no}')]]"
)
row = wait.until(EC.presence_of_element_located((By.XPATH, row_xpath)))
row.find_element(By.XPATH, ".//span[text()='删除']").click()
# 二次确认弹窗
wait.until(EC.element_to_be_clickable((By.XPATH, "//button[span[text()='确 定']]"))).click()
要点:
- 等
.ant-spin-spinning消失,而不是页面 load 完就点 - 操作按钮可能是
<a>、<span>或图标按钮,不要写死button - 「更多」菜单要先点开再选,否则元素在 DOM 里但不可点击
六、常见写法 5:搜索 + 断言(表格用例里最容易漏的)
很多用例不是「点行内按钮」,而是 搜完以后列表里有没有这条数据:
search_input = wait.until(EC.element_to_be_clickable((By.ID, "order-search")))
search_input.clear()
search_input.send_keys(order_no)
driver.find_element(By.CSS_SELECTOR, "button.search-btn").click()
wait.until(EC.invisibility_of_element_located((By.CSS_SELECTOR, ".ant-spin-spinning")))
# 断言:tbody 里出现该订单号
rows = driver.find_elements(By.CSS_SELECTOR, "table tbody tr")
assert any(order_no in row.text for row in rows), f"列表未找到订单 {order_no}"
搜索会缩小 DOM 范围,比在全表几千行里遍历更稳,也更快。
七、六个典型坑
坑 1:表格还没加载完就开始点
现象: NoSuchElementException、ElementNotInteractableException,本地手动刷新有时又能过。
原因: 只等了 <table> 出现,但 tbody 还是空的,或 Ant Design 仍在 loading。
做法:
# 不要只用 time.sleep(3)
wait.until(EC.presence_of_element_located((By.CSS_SELECTOR, "table tbody tr")))
wait.until(EC.invisibility_of_element_located((By.CSS_SELECTOR, ".ant-spin-spinning")))
# 若有「暂无数据」占位,先确认不是空态
列表接口慢的环境,可以等 某一行的关键单元格 出现,而不是任意 tr。
坑 2:用「会重复的文案」定位行
现象: 点到了别人的行,或断言误报。
原因: 用「正常」「启用」「2026-03-19」这种多行都有的字段当唯一键。
做法: 优先订单号、工号、邮箱、主键 ID;断言用 包含 唯一业务键,而不是整行 text 全等。
坑 3:class 名、列顺序写死
现象: 前端把 btn-edit 改成 btn-primary,或产品加了一列「状态」,脚本点错列。
做法:
- 行:按业务字段文本或
data-row-key(Ant Design 行常有) - 列:按表头语义找列索引,或按按钮文案 /
aria-label - 避免
td:nth-child(7)这种除非列结构合同级稳定
Ant Design 示例:
row = driver.find_element(
By.CSS_SELECTOR,
f"tr[data-row-key='{order_id}']"
)
坑 4:行内「更多」菜单没展开就点
现象: 元素在 DOM 里,click() 无效或点到透明层。
做法: 先点「更多」/ 三个点图标,等菜单可见再点「删除」:
row.find_element(By.CSS_SELECTOR, ".ant-dropdown-trigger").click()
wait.until(EC.visibility_of_element_located((By.XPATH, "//li[contains(.,'删除')]"))).click()
坑 5:翻页后还用「第 3 行」
现象: 第一页测得好好的,加数据或默认排序一变就挂。
做法: 翻页用例单独写;跨页找数据应用 搜索 把目标行拉到第一页,或循环翻页直到找到(注意设最大页数防死循环):
def go_to_page(driver, page_num: int):
driver.find_element(
By.XPATH,
f"//li[contains(@class,'ant-pagination-item') and @title='{page_num}']"
).click()
wait.until(EC.invisibility_of_element_located((By.CSS_SELECTOR, ".ant-spin-spinning")))
坑 6:断言太弱或太死
太弱: 只断言 table 存在 → 空表也绿。
太死: 断言整行 HTML 或带时间戳、随机 ID 的全文 → 业务正常也红。
做法:
# 好:关键字段出现
assert order_no in driver.find_element(By.CSS_SELECTOR, "table tbody").text
# 更好:指定列(按表头找列索引后取单元格)
# 动态 ID 用正则
import re
assert re.search(r"ORD-\d{8}-\d{3}", row.text)
八、维护建议(脚本长期能用的几条)
- 封装「等表格就绪」「按关键字找行」「点行内按钮」,别在每个用例里复制 XPath。
- 一条用例只测一条业务路径,搜索、创建、查列表、点编辑拆开,失败才好定位。
- 测试数据用唯一前缀(如
auto-{timestamp}),避免和别人的数据撞行。 - 截图 + 失败时打印当前 tbody 文本,排障比只看 stacktrace 快得多。
- 组件库升级时优先回归表格用例,Ant / Element 升版本 DOM 变得最多。
Selenium 测表格没有银弹,核心始终是:等业务字段稳定、等加载完成、行内用相对定位、断言对准可观测结果。
九、如果主要卡在「写定位和维护」,还有更轻的方式
上面这些写法团队里肯定有人能写。真正拖住小团队的,往往是:
- 页面加一列、按钮进「更多」,就要改一串 XPath
- 失败只有堆栈,没有「第几步、当时表格长什么样」
- 会写脚本的只有一个人,他忙就没人改
如果你们的场景是 Web 后台的表格查、点、断言,目标是 发版前几条主路径能重复跑,不一定每条都要上 Selenium 工程。可以在真实页面上 录制 把路径先沉淀下来。
回演 CueCast 走的是这条路线:在浏览器里像平时一样操作表格,步骤同步到中台,可回放、可编辑。表格场景里通常只需要做下面几件事:
1. 建用例,起始 URL 直接打开列表页
已登录就从列表页开始录;登录单独录一条用例,执行计划里用「登录准备」按需再登。不要每条都从首页点进菜单。
2. 开始录制,按真实操作走一遍
例如:输入搜索条件 → 点查询 → 点某一行的「编辑」→ 改字段 → 提交。和人工测试一样点即可。Ant Design、Element、iView 以及原生 table 都支持;行内点击时会记录行列上下文,同结构多行里点「编辑」时比手写 //tr[3]/td[8] 更不容易点错。
3. 补一条短断言
例如整页文本 包含 刚创建的订单名,或列表里出现某个唯一字段。不要断言整表 HTML,也不要写死时间戳。
4. 回放,失败只看那一步
结果里能看到失败步骤序号、截图和错误信息。定位飘了只改那一步,或从该步「继续录制」,不必整条重写。
5. 放进执行计划,和其他核心路径一起跑
发版前跑一遍:登录准备 → 表格查询 → 创建 → 编辑 → …… 冒烟可设「失败即停止」。

和 Selenium 怎么选?
| 场景 | 更合适 |
|---|---|
| 要进 CI、跨浏览器、复杂 Fixture / Mock | Selenium / Playwright |
| 表格主路径、频繁改版、没有专职测试开发维护脚本 | 先录制沉淀,再视情况补代码框架 |
| 虚拟滚动超万行、纯接口构造数据 | 代码 + 接口测试;UI 只测关键几行 |
不是二选一。很多团队用 CueCast 盖住 发版必测的表格主路径,复杂链路仍用 Playwright。CueCast 也不替代你在本文里学的那些坑——异步加载、唯一业务键、弱断言 在录制用例里同样要注意,只是不用自己维护 XPath 而已。
产品入口:回演 CueCast
文档:录制第一个用例
小结
- 按 业务唯一字段 找行,再在行内 相对定位 点操作列。
- 必须 等表格数据加载完(含 Ant Design 的 loading)。
- 少依赖 行列序号 和 动态 class。
- 搜索 往往比翻页遍历更稳。
- 断言 对准关键字段,勿弱勿死。
表格是 Selenium 里最适合写教程、也最容易踩坑的场景。把脚本写稳需要功夫;如果当前瓶颈是「没人持续改脚本」,不妨先用录制把几条表格主路径跑起来,再决定要不要上完整框架。

后台列表页几乎都有表格:搜索、点行内操作、翻页、断言某行数据。本文用 Python + Selenium 讲几种常见表格定位写法,以及动态加载、同文案多行、组件库表格等 6 个典型坑。若你主要卡在定位和维护,文末也有一种在真实页面上录制的主路径做法。
浙公网安备 33010602011771号