1. 为什么说 pytest 和 playwright 是“黄金组合”?
如果你做过 Web 自动化测试,肯定经历过这样的痛苦:写一个测试脚本,光是处理各种等待(sleep)就让人头大,浏览器兼容性问题更是“玄学”,今天 Chrome 能跑通,明天 Firefox 就报错。测试用例一多,管理起来也是一团乱麻,哪个失败了、为什么失败,排查起来像大海捞针。
我做了这么多年测试,用过不少工具,从早期的 Selenium 到后来的 Puppeteer,直到遇到了 pytest 和 playwright 这对组合,才真正体会到什么叫“无缝”和“高效”。这俩工具单独拿出来都很能打,但组合在一起,产生的化学反应远超你的想象。简单来说,pytest 就像一个经验丰富的测试指挥官,负责排兵布阵、制定规则、汇总战报;而 playwright 则是一个全能的特种兵,能同时在 Chrome、Firefox、Safari 等多个“战场”上精准执行命令,而且自带“预判”能力,不用你反复催促。
这个组合的核心优势,我总结为三点:写起来简单、跑起来稳定、管起来省心。你不用再写一大堆 time.sleep(5) 来等页面加载,playwright 的自动等待机制能智能判断元素是否就绪。你也不用为每个浏览器写一套不同的脚本,playwright 的 API 是跨浏览器一致的。更重要的是,pytest 提供了从用例组织、数据驱动、到报告生成的一整套“基础设施”,让你能把精力真正放在测试逻辑本身,而不是繁琐的框架搭建上。
接下来,我就带你从零开始,一步步搭建这个“黄金组合”,并分享我在实际项目中踩过的坑和总结的最佳实践,保证你跟着做就能上手。
2. 环境搭建:5分钟搞定你的第一个测试
万事开头难,但这次开头真的不难。我们先把舞台搭好。
2.1 安装依赖:一行命令的事
打开你的命令行终端(CMD、PowerShell 或 Terminal),创建一个新的项目目录,然后执行下面两条命令。我强烈建议你使用虚拟环境(比如 venv 或 conda),避免包版本冲突。
# 安装 pytest 和 playwright 的 Python 包
pip install pytest playwright
# 安装 playwright 所需的浏览器内核(Chromium, Firefox, WebKit)
playwright install
第一行命令会安装核心的 Python 包。第二行命令 playwright install 非常关键,它会自动下载 Chromium、Firefox 和 WebKit(Safari 内核)的可执行文件到本地。这个过程需要一点时间,取决于你的网络,但请确保它顺利完成。如果卡住,可以试试设置国内镜像源,或者使用 playwright install chromium 先只安装最常用的 Chromium。
安装完成后,你可以快速验证一下:
pytest --version
playwright --version
能看到版本号,就说明基础环境 OK 了。
2.2 编写你的第一个测试脚本
环境有了,我们来写一个最简单的测试,感受一下这个组合的流畅度。创建一个名为 test_quick_start.py 的文件。
import pytest
from playwright.sync_api import Page, expect
def test_visit_playwright_homepage(page: Page):
"""
测试:访问 Playwright 官网,并验证标题
"""
# 1. 导航到页面
page.goto("https://playwright.dev/python")
# 2. 使用 expect 进行断言(这是 Playwright 推荐的异步安全断言)
expect(page).to_have_title("Fast and reliable end-to-end testing for modern web apps | Playwright Python")
# 3. 也可以结合 pytest 的原生 assert
assert "Playwright" in page.title()
# 4. 点击一个链接并验证跳转
docs_link = page.get_by_role("link", name="Docs")
docs_link.click()
expect(page).to_have_url("https://playwright.dev/python/docs/intro")
这个脚本里已经包含了几个核心概念:
pageFixture:这是 pytest-playwright 插件提供的,你不用自己创建浏览器实例和页面,框架已经帮你管理好了。直接在测试函数参数里声明page: Page就能用。- 自动等待:
page.goto()、click()这些操作,playwright 会自动等待网络请求完成、元素可交互等条件,省去了无数sleep。 expectAPI:这是 playwright 的断言库,它是异步安全的,并且能提供更友好的错误信息。当然,你依然可以用传统的assert。- 定位器:
page.get_by_role("link", name="Docs")是一种推荐的定位方式,它基于可访问性角色,比脆弱的 CSS 选择器更稳定。
现在,在终端运行这个测试:
pytest test_quick_start.py -v
你会看到浏览器(默认是 Chromium)自动打开,快速执行操作然后关闭,终端打印出绿色的 PASSED。是不是比想象中简单?这还只是开胃菜。
3. 核心技巧:让测试更健壮、更易维护
脚本能跑起来只是第一步,写出能在团队协作和持续集成中稳定运行的测试才是关键。下面这几个技巧是我从无数个“坑”里总结出来的。
3.1 善用 Fixture:管理测试的生命周期
pytest 的 Fixture 是管理测试依赖和资源的利器。结合 playwright,我们可以自定义一些非常强大的 Fixture。比如,我不想每次测试都打开新的浏览器,太慢了;但所有测试用一个浏览器,又怕互相干扰。怎么办?可以设置浏览器上下文级别的隔离。
创建一个 conftest.py 文件(pytest 会自动发现这个文件):
import pytest
from playwright.sync_api import Playwright, Browser, BrowserContext
@pytest.fixture(scope="session")
def playwright_instance():
"""在整个测试会话中,只启动一次 Playwright 实例"""
with sync_playwright() as p:
yield p
@pytest.fixture(scope="session")
def browser(playwright_instance: Playwright):
"""会话级浏览器实例,所有测试共享一个浏览器进程"""
# 这里可以配置启动参数,比如无头模式、慢速模拟等
browser = playwright_instance.chromium.launch(headless=True, slow_mo=500) # headless=True 表示无界面,适合CI环境
yield browser
browser.close()
@pytest.fixture(scope="function")
def context(browser: Browser):
"""函数级的浏览器上下文,每个测试函数一个独立的‘隐身模式’会话"""
context = browser.new_context(
viewport={'width': 1920, 'height': 1080},
ignore_https_errors=True
)
yield context
context.close()
@pytest.fixture(scope="function")
def page(context: BrowserContext):
"""函数级的页面,这是最常用的 Fixture"""
page = context.new_page()
yield page
page.close()
这样配置后,你的测试函数只需要请求 page 这个 Fixture。每个测试都会获得一个干净的、独立的页面环境(包括独立的 cookies、localStorage),但背后共享同一个浏览器进程,速度大大提升。scope 参数控制生命周期,session(整个 pytest 执行过程一次)、function(每个测试函数一次)是最常用的。
3.2 参数化测试:用一份代码覆盖多种场景
这是 pytest 的杀手级功能。假设你要测试一个登录功能,需要验证正常登录、密码错误、用户名不存在等多种情况。不用写多个重复的函数,一个参数化搞定。
import pytest
# 测试数据可以放在这里,也可以从文件(如JSON, CSV)中读取
LOGIN_TEST_DATA = [
("correct_user", "correct_password", True, "登录成功"),
("wrong_user", "some_password", False, "用户名不存在"),
("correct_user", "wrong_password", False, "密码错误"),
("", "some_password", False, "用户名为空"),
]
@pytest.mark.parametrize("username, password, expected_success, expected_message", LOGIN_TEST_DATA)
def test_login_with_parameters(page: Page, username, password, expected_success, expected_message):
page.goto("https://your-app.com/login")
page.fill("#username", username)
page.fill("#password", password)
page.click("#submit-btn")
if expected_success:
# 期望登录成功,跳转到首页
expect(page).to_have_url("https://your-app.com/dashboard")
welcome_text = page.locator(".welcome-message")
expect(welcome_text).to_contain_text(username)
else:
# 期望登录失败,显示错误信息
error_toast = page.locator(".error-message")
expect(error_toast).to_be_visible()
expect(error_toast).to_contain_text(expected_message)
运行测试时,pytest 会自动将这个函数展开成 4 个独立的测试用例来执行,并在报告里清晰显示每条数据对应的结果。这极大地提升了测试覆盖率和代码复用度。
3.3 元素定位策略:告别“选择器地狱”
UI 自动化测试最不稳定的一环就是元素定位。页面结构一变,你的 CSS 选择器可能就失效了。Playwright 提供了一系列面向用户的定位器,优先级应该从高到低如下:
get_by_role():通过 ARIA 角色定位,如button、link、textbox。这是最推荐的方式,因为它最接近用户感知方式,且与实现细节解耦。page.get_by_role("button", name="登录") page.get_by_role("textbox", name="用户名")get_by_text()和get_by_label():通过文本内容或关联的 label 文本定位。page.get_by_text("同意并继续") page.get_by_label("电子邮件地址")get_by_test_id():这是最强力的定位方式。你需要让开发同学在元素上添加data-testid属性(如<button data-testid="login-submit">)。这个属性专为测试而设,几乎不会因为样式调整而改变。page.get_by_test_id("login-submit").click()- CSS 和 XPath:作为最后的手段。尽量使用有语义的 CSS 选择器,避免使用长的、脆弱的 XPath。
注意:永远优先使用前三种定位器。和前端团队约定使用
data-testid,是提升自动化测试稳定性的最有效投资。
4. 高级实战:处理复杂场景与集成
当你的测试套件逐渐庞大,你会遇到更多挑战:如何处理文件上传?怎么模拟键盘操作?测试报告太丑怎么办?别急,都有解。
4.1 处理常见“棘手”操作
- 文件上传:Playwright 让这个曾经很麻烦的操作变得极其简单。
# 假设有一个 <input type="file"> 元素 page.locator("input[type='file']").set_input_files("/path/to/your/file.jpg") # 甚至可以上传多个文件 page.locator("input[type='file']").set_input_files(["file1.jpg", "file2.png"]) - 键盘与鼠标操作:
# 键盘操作 page.locator("#search-box").press("Control+A") # 全选 page.locator("#search-box").press("Delete") # 删除 page.keyboard.type("Hello World!") # 直接键盘输入 # 鼠标操作 page.locator(".draggable").hover() # 悬停 page.locator(".draggable").drag_to(page.locator(".drop-target")) # 拖放 - iframe 处理:直接定位到 iframe 内部进行操作。
# 通过 iframe 的 name 属性或选择器定位 iframe = page.frame(name="chat-widget") # 然后在 iframe 上下文里操作 iframe.fill("input", "消息内容") iframe.click("button")
4.2 生成漂亮的测试报告
pytest 有丰富的报告插件。我最常用的是 pytest-html 和 pytest-allure。
安装 pytest-html:
pip install pytest-html
运行测试并生成报告:
pytest --html=report.html --self-contained-html
这会生成一个独立的 report.html 文件,打开后可以看到清晰的测试结果汇总、通过/失败列表,甚至每个失败用例的截图(需要额外配置)。对于团队分享和问题追溯非常有用。
如果你想更专业,可以集成 Allure2,它能生成非常炫酷的交互式报告,展示测试趋势、环境信息等。
4.3 集成到 CI/CD 流水线
自动化测试只有集成到持续集成/持续部署流程中,才能最大化其价值。以 GitHub Actions 为例,一个简单的 .github/workflows/test.yml 配置如下:
name: Web Automation Tests
on: [push, pull_request]
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Set up Python
uses: actions/setup-python@v4
with:
python-version: '3.10'
- name: Install dependencies
run: |
pip install -r requirements.txt
playwright install --with-deps chromium # 在CI中通常只安装一个浏览器以加快速度
- name: Run tests
run: |
pytest --html=report.html --self-contained-html
- name: Upload test report
uses: actions/upload-artifact@v3
with:
name: html-report
path: report.html
这个配置会在每次代码推送或拉取请求时,自动在一个干净的 Ubuntu 环境中安装依赖、运行你的 pytest + playwright 测试套件,并将生成的 HTML 报告保存为工件,供你下载查看。这样,代码的质量门禁就建立起来了。
5. 避坑指南:我踩过的那些“雷”
最后,分享几个我实际项目中遇到的典型问题和解决方案,希望能帮你少走弯路。
-
坑1:测试在 CI 上失败,本地却成功。
- 原因:最常见的是环境差异。CI 服务器是无头(headless)模式,且可能屏幕分辨率、时区、语言环境与本地不同。
- 解决:永远在 CI 镜像或配置中明确指定浏览器启动参数。使用
viewport设置固定分辨率,使用locale设置语言,并在 CI 脚本中安装所有必需的浏览器依赖(playwright install --with-deps)。另外,在本地也尽量用headless=True模式跑一遍,提前发现问题。
-
坑2:元素定位器偶尔失效,报
TimeoutError。- 原因:除了页面真的加载慢,更多时候是动态内容(如 Vue/React 组件)还没完全渲染好,或者元素被遮挡、状态未改变。
- 解决:首先,检查是否使用了推荐的
get_by_role、get_by_test_id等定位器。其次,善用 Playwright 的等待策略,而不是粗暴的page.wait_for_timeout(5000)。# 等待元素出现并可交互 element = page.locator("button.submit") element.wait_for(state="attached") # 等待附加到DOM element.wait_for(state="visible") # 等待可见 element.wait_for(state="hidden") # 等待隐藏 # 或者直接使用带自动等待的操作 element.click() # 这个click内部已经包含了等待可交互的逻辑
-
坑3:测试数据互相污染。
- 原因:多个测试用例使用了同一个用户账号,或者操作了同一份数据,导致后续测试失败。
- 解决:这就是为什么我们要用
BrowserContext(见 3.1 节)。每个测试函数一个独立的 Context,天然隔离。对于更复杂的数据依赖,可以考虑在测试开始前通过 API 创建唯一的数据(如随机生成用户名),测试结束后再清理。
-
坑4:异步操作处理不当。
- 原因:Playwright 的 API 默认是同步的(
sync_api),但现代网页大量使用异步请求。有时你的断言执行得太快,数据还没从服务器返回。 - 解决:对于明确需要等待网络请求的场景,使用
page.wait_for_response()或page.wait_for_request()。# 点击删除按钮,并等待对应的API请求完成 with page.expect_response("**/api/item/delete") as response_info: page.click("button.delete") response = response_info.value assert response.ok # 然后再断言页面上的元素被移除 expect(page.locator(".item-list")).to_have_count(0)
- 原因:Playwright 的 API 默认是同步的(
把这些点都注意到,你的 pytest + playwright 测试套件就能从“能跑”进化到“跑得稳”,真正成为项目开发中值得信赖的安全网。这套组合拳打下来,你会发现编写和维护自动化测试不再是负担,而是一种高效的质量保障手段。
251



被折叠的 条评论
为什么被折叠?



