AIGC标识 Selenium 如何测试表格?常见写法与 6 个坑(Python 示例)

后台管理系统里,表格是最常见、也最容易把自动化写「脆」的控件之一。

查询列表、点某一行的「编辑 / 删除 / 详情」、翻页后再断言数据——这些路径几乎每个团队都要测。用 Selenium 做 UI 自动化时,表格相关脚本往往占很大比重,也常常是 第一次能跑、改两次页面就全红 的重灾区。

本文用 Python + Selenium 4 说明几种常见写法,再集中讲 6 个坑。示例假设页面是常见的 HTML <table> 或 Ant Design Table;Element UI、iView 的思路类似,只是 DOM 结构不同,定位策略要跟着改。


一、先约定:表格测试通常要测什么

一条完整的「表格用例」,一般包含:

  1. 进入列表页(可能要先登录、先搜索)
  2. 等到表格数据加载完成
  3. 定位到目标行(按业务字段,如订单号、用户名)
  4. 对该行做操作(点击编辑、删除、勾选)
  5. 断言结果(弹窗、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)

八、维护建议(脚本长期能用的几条)

  1. 封装「等表格就绪」「按关键字找行」「点行内按钮」,别在每个用例里复制 XPath。
  2. 一条用例只测一条业务路径,搜索、创建、查列表、点编辑拆开,失败才好定位。
  3. 测试数据用唯一前缀(如 auto-{timestamp}),避免和别人的数据撞行。
  4. 截图 + 失败时打印当前 tbody 文本,排障比只看 stacktrace 快得多。
  5. 组件库升级时优先回归表格用例,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 里最适合写教程、也最容易踩坑的场景。把脚本写稳需要功夫;如果当前瓶颈是「没人持续改脚本」,不妨先用录制把几条表格主路径跑起来,再决定要不要上完整框架。

posted @ 2026-08-21 16:23  metaluo  阅读(20)  评论(0)    收藏  举报