1. 项目概述为什么是时候告别 Selenium拥抱 Playwright 了如果你是一名Web自动化测试工程师或者正在学习自动化测试那么“Selenium”这个名字对你来说一定如雷贯耳。它统治了这个领域超过十年是无数测试框架的基石。但最近一两年一个叫“Playwright”的新秀正在迅速崛起并且在很多技术社区和招聘要求中它的出现频率越来越高。我本人从Selenium 2.0时代开始用它做过无数项目也踩过无数的坑。直到去年在一个对稳定性和执行速度要求极高的企业级项目中我被迫全面转向Playwright这才发现我们可能真的到了一个技术栈更新的十字路口。这篇指南就是我基于这次彻底的技术迁移和后续多个实战项目的经验总结。它不是一篇简单的工具对比而是一份从“为什么换”到“怎么换”再到“如何用好”的完整路线图。我会带你深入理解Playwright的设计哲学手把手搭建从零到一的环境详解其核心API的现代用法并最终构建一个可复用的、健壮的企业级测试框架。你会发现Playwright解决的不仅仅是Selenium的“慢”和“不稳定”它更带来了一套全新的、面向现代Web应用的自动化思维。无论你是被Selenium的异步加载、动态元素折磨得焦头烂额的老手还是刚刚入门、不想在过时的技术上浪费时间的新人这篇文章都将为你提供一条清晰的进阶路径。2. Playwright 核心优势深度解析不止是“更快更稳”很多人初识Playwright听到的都是“它比Selenium快”、“它更稳定”。这没错但这些都是结果而非原因。要真正理解它的价值我们必须深入到其架构设计层面。2.1 架构革新从“翻译官”到“原生支持”Selenium WebDriver的核心工作模式是一个“翻译官”。你的测试脚本比如用Python写的通过WebDriver协议发送指令给一个浏览器驱动程序如ChromeDriver这个驱动程序再通过浏览器的调试协议如Chrome DevTools Protocol去控制浏览器。这个链条长任何一环的延迟或不稳定都会导致整个测试的脆弱。graph TD subgraph Selenium A[测试脚本 Python/Java] -- B[WebDriver 协议]; B -- C[浏览器驱动 ChromeDriver]; C -- D[浏览器调试协议 CDP]; D -- E[浏览器 Chrome]; end而Playwright则采取了“直连”模式。它由微软团队开发直接与Chromium、Firefox和WebKitSafari三大浏览器引擎的官方团队合作为每个浏览器都定制开发了一个专用的“Playwright驱动程序”。这个驱动程序直接内嵌了对浏览器自动化协议的原生、深度支持跳过了WebDriver这个中间层。这意味着更少的协议转换、更直接的命令执行和更丰富的控制能力。graph TD subgraph Playwright F[测试脚本 Node.js/Python/.NET/Java] -- G[Playwright 核心库]; G -- H[Playwright 专用驱动 for Chromium]; G -- I[Playwright 专用驱动 for Firefox]; G -- J[Playwright 专用驱动 for WebKit]; H -- K[浏览器 Chromium]; I -- L[浏览器 Firefox]; J -- M[浏览器 Safari]; end这种架构带来的直接好处就是速度和稳定性。命令执行更快因为链路更短稳定性更高因为Playwright团队可以针对每个浏览器的特性进行深度优化而不是依赖一个通用的、可能更新滞后的标准协议。2.2 自动等待告别显式等待的“智能”等待这可能是让Selenium用户幸福感提升最明显的一点。在Selenium中处理动态加载的元素是一场噩梦。你必须到处写WebDriverWait并精心设计等待条件expected_conditions一个不小心就会因为元素未加载而抛出NoSuchElementException或TimeoutException。Playwright内置了“自动等待”机制。它的绝大多数操作如click,fill,text_content在执行前都会自动等待目标元素满足一系列可操作性条件元素被附加到DOM中、可见、未被禁用、稳定没有动画等。这意味着在绝大多数情况下你只需要写page.click(‘button#submit’)Playwright会帮你等到这个按钮真正可以点击时才去点击。# Selenium 方式必须显式等待 from selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC from selenium.webdriver.common.by import By element WebDriverWait(driver, 10).until( EC.element_to_be_clickable((By.ID, “submit”)) ) element.click() # Playwright 方式自动等待 page.click(“button#submit”) # 这一行代码等价于上面Selenium的所有代码当然自动等待不是万能的。对于某些非标准的加载状态比如等待某个特定网络请求完成你仍然需要使用page.wait_for_function()或page.wait_for_event()等方法。但日常90%的等待场景都被覆盖了代码简洁度和可维护性有了质的飞跃。2.3 多上下文与多页面模拟真实用户场景的利器现代Web应用大量使用多标签页、弹出窗口、Iframe。Selenium对此的支持比较笨拙需要手动切换句柄window_handles代码容易混乱。Playwright引入了BrowserContext的概念。你可以把它理解为一个独立的、隔离的浏览器会话。每个Context拥有独立的cookie、localStorage、会话历史就像你用浏览器的“无痕模式”新开了一个窗口。在一个Browser实例下你可以创建多个Context在每个Context里又可以打开多个Page标签页。这种模型非常清晰地映射了真实用户的使用模式。import asyncio from playwright.async_api import async_playwright async def main(): async with async_playwright() as p: browser await p.chromium.launch(headlessFalse) # 创建两个独立的上下文如模拟两个用户 context1 await browser.new_context() context2 await browser.new_context() # 在每个上下文中打开页面 page1 await context1.new_page() page2 await context2.new_page() # page1和page2完全隔离cookie互不影响 await page1.goto(“https://example.com/login”) await page1.fill(“#username”, “user1”) # ... await page2.goto(“https://example.com/login”) await page2.fill(“#username”, “user2”) # 可以同时登录不同账号 # ... await browser.close() asyncio.run(main())这个特性对于测试需要登录态隔离、并行执行不同用户场景的用例来说简直是神器。管理Iframe也变得异常简单page.frame(“frame-name”)或page.frame_locator(“iframe”).locator(“button”)直接定位无需切换。2.4 强大的网络拦截与模拟Playwright允许你监听和修改页面发出的任何网络请求这为测试提供了前所未有的灵活性。拦截请求你可以阻止某些请求比如阻止广告或跟踪脚本加载或者修改请求头、请求体。模拟响应你可以直接为特定的URL模式返回一个自定义的响应而无需经过真实服务器。这在测试边缘场景如服务器错误、慢速网络或依赖第三方不可控API时非常有用。等待请求可以等待某个特定请求发出并完成这对于测试依赖于AJAX操作的交互至关重要。# 拦截并修改请求 await page.route(“**/*.{png,jpg,jpeg}”, lambda route: route.abort()) # 阻止图片加载加速测试 # 模拟API响应 await page.route(“**/api/user”, lambda route: route.fulfill( status200, content_type“application/json”, bodyjson.dumps({“name”: “Mock User”, “id”: 123}) )) # 等待请求完成 async with page.expect_request(“**/api/submit”) as request_info: await page.click(“#submit-btn”) request await request_info.value print(request.url, request.method)2.5 原生移动端模拟与代码生成器Playwright支持直接模拟移动设备如iPhone、Pixel的视口、User-Agent、触摸事件等无需启动复杂的模拟器或真机。结合多浏览器支持一套脚本可以轻松覆盖桌面端和移动端的响应式测试。此外Playwright内置的代码生成器playwright codegen是快速上手和编写脚本的利器。你只需在命令行启动它然后像普通用户一样操作浏览器它就会实时生成对应操作的代码支持Python、Java、C#、JavaScript大大提升了编写测试用例的效率尤其适合为已有功能快速生成测试骨架。3. 从零开始Playwright 环境搭建与核心API精讲理论说得再多不如动手实践。让我们从安装开始一步步掌握Playwright的核心用法。3.1 环境安装与初始化Playwright支持多种语言但以其原生支持Node.js和Python版本最为流行和成熟。这里以Python为例。# 1. 使用pip安装playwright库 pip install playwright # 2. 安装Playwright所需的浏览器二进制文件Chromium, Firefox, WebKit playwright install注意playwright install会下载所有三个浏览器的稳定版本这可能需要一些时间和磁盘空间约1.5GB。如果只想安装特定浏览器可以使用playwright install chromium。在企业内网环境可能需要配置代理或使用离线安装包。安装完成后一个最简单的脚本如下from playwright.sync_api import sync_playwright def run(): with sync_playwright() as p: # 启动浏览器headlessFalse表示显示UI browser p.chromium.launch(headlessFalse) # 创建页面上下文和页面 page browser.new_page() # 导航到网址 page.goto(“https://www.example.com”) # 截图 page.screenshot(path“example.png”) # 关闭浏览器 browser.close() if __name__ “__main__”: run()3.2 元素定位与操作告别XPath地狱Playwright提供了多种强大且稳定的定位器Locator。最佳实践是优先使用面向用户的定位器Role, Text其次是Test ID尽量避免使用脆弱的XPath或CSS选择器。按角色和文本定位最推荐这是最接近用户视角的方式可读性高对前端代码改动不敏感。# 点击一个名为“登录”的按钮 page.get_by_role(“button”, name“登录”).click() # 填写一个标签为“用户名”的输入框 page.get_by_label(“用户名”).fill(“myuser”) # 点击包含特定文本的元素 page.get_by_text(“Welcome back”).click()使用测试IDTest ID这是与开发协作的最佳方式。让开发在关键元素上添加>!-- 前端代码 -- button># 测试脚本 page.get_by_test_id(“login-submit-btn”).click()CSS和XPath定位在以上方法不适用时使用。Playwright的locator()方法接受CSS选择器或XPath。page.locator(“#search-input”).fill(“query”) page.locator(“//button[contains(class, ‘primary’)]”).click()实操心得尽量避免使用过于复杂或依赖绝对路径的XPath。它们极其脆弱前端一个简单的div嵌套变动就可能导致定位失败。CSS选择器通常比XPath性能更好也更简洁。元素操作非常简单直观并且内置自动等待# 输入文本 page.locator(“#email”).fill(“testexample.com”) # 点击 page.locator(“button:has-text(‘Submit’)”).click() # 获取文本 text page.locator(“.status-message”).text_content() # 获取属性值 href page.locator(“a.link”).get_attribute(“href”) # 勾选复选框 page.locator(“#agree-terms”).check() # 选择下拉框选项 page.locator(“#country”).select_option(“CN”)3.3 处理弹窗、对话框和下载Playwright对浏览器原生对话框alert, confirm, prompt的处理是监听事件而非在对话框弹出后操作。# 监听并接受confirm对话框 page.on(“dialog”, lambda dialog: dialog.accept()) page.click(“button#delete”) # 点击会触发confirm的按钮 # 更精确的控制 def handle_dialog(dialog): print(dialog.message) if “confirm” in dialog.message: dialog.accept() else: dialog.dismiss() page.on(“dialog”, handle_dialog)处理文件下载也非常优雅# 等待下载事件 async with page.expect_download() as download_info: page.click(“a#download-link”) download await download_info.value # 获取下载文件路径或保存到指定位置 path await download.path() await download.save_as(“/path/to/save/file.pdf”)3.4 异步Async与同步SyncAPIPlaywright原生是基于异步IONode.js设计的但也为Python、Java、C#提供了友好的同步API封装。选择哪个取决于你的项目和技术栈。异步API性能更高适合I/O密集型操作和高并发测试场景。使用async/await语法。from playwright.async_api import async_playwright import asyncio async def main(): async with async_playwright() as p: browser await p.chromium.launch() page await browser.new_page() await page.goto(“https://example.com”) # ... 其他异步操作 await browser.close() asyncio.run(main())同步API写法更简单直观类似于传统的Selenium脚本适合线性脚本或初学者。使用sync_playwright。from playwright.sync_api import sync_playwright with sync_playwright() as p: browser p.chromium.launch() page browser.new_page() page.goto(“https://example.com”) # ... 其他同步操作 browser.close()注意事项如果你在像pytest这样的测试框架中混用异步和同步代码需要小心处理事件循环。通常建议在一个项目内保持一致风格。对于复杂的、需要并行操作多个页面的测试异步API优势明显。4. 构建企业级测试框架从用例编写到CI/CD集成掌握了核心API我们就可以着手搭建一个健壮、可维护、可扩展的测试框架了。一个好的框架能提升团队效率降低维护成本。4.1 项目结构与设计模式一个典型的企业级Playwright测试项目结构如下my-automation-framework/ ├── conftest.py # Pytest全局配置、Fixture定义 ├── pytest.ini # Pytest配置文件 ├── requirements.txt # Python依赖 ├── playwright.config.ts/js # Playwright Test专用配置如使用PW Test ├── pages/ # 页面对象模型Page Object Model │ ├── __init__.py │ ├── base_page.py # 基础页面类 │ ├── login_page.py │ └── dashboard_page.py ├── locators/ # 定位器集中管理可选 │ ├── login_locators.py │ └── ... ├── tests/ # 测试用例 │ ├── __init__.py │ ├── test_login.py │ ├── test_dashboard.py │ └── smoke_tests/ ├── fixtures/ # 测试数据夹具 │ └── test_data.json ├── utils/ # 工具函数 │ ├── api_client.py │ ├── logger.py │ └── helpers.py ├── reports/ # 测试报告输出目录 └── artifacts/ # 临时文件、截图、录屏通常由工具自动生成核心设计模式页面对象模型Page Object Model, POMPOM是UI自动化测试的黄金标准。它将页面的元素定位和操作封装成类测试用例只关心业务逻辑不与具体的HTML结构耦合。# pages/base_page.py from playwright.sync_api import Page class BasePage: def __init__(self, page: Page): self.page page self.timeout 30000 def navigate(self, url): self.page.goto(url) def take_screenshot(self, name): self.page.screenshot(pathf”./screenshots/{name}.png”) # pages/login_page.py from .base_page import BasePage class LoginPage(BasePage): # 定位器作为类属性 USERNAME_INPUT “#username” PASSWORD_INPUT “#password” LOGIN_BUTTON “button[type‘submit’]” ERROR_MSG “.alert-error” def __init__(self, page: Page): super().__init__(page) def login(self, username: str, password: str): 登录操作 self.page.fill(self.USERNAME_INPUT, username) self.page.fill(self.PASSWORD_INPUT, password) self.page.click(self.LOGIN_BUTTON) def get_error_message(self) - str: 获取错误信息 return self.page.text_content(self.ERROR_MSG)4.2 使用Pytest进行测试组织与Fixture管理Pytest是Python生态中最强大的测试框架与Playwright结合得天衣无缝。我们可以利用Pytest的Fixture来管理浏览器、页面上下文和测试数据。# conftest.py import pytest from playwright.sync_api import Page, BrowserContext, Browser from pages.login_page import LoginPage from pages.dashboard_page import DashboardPage pytest.fixture(scope“session”) def browser(): 启动浏览器实例整个测试会话只启动一次 from playwright.sync_api import sync_playwright with sync_playwright() as p: # 可以在这里配置启动参数如无头模式、窗口大小、代理等 browser p.chromium.launch(headlessTrue, args[“--start-maximized”]) yield browser browser.close() pytest.fixture def context(browser): 为每个测试用例创建一个独立的浏览器上下文 context browser.new_context( viewport{‘width’: 1920, ‘height’: 1080}, ignore_https_errorsTrue # 忽略HTTPS证书错误用于测试环境 ) yield context context.close() pytest.fixture def page(context): 为每个测试用例提供一个干净的页面 page context.new_page() yield page page.close() pytest.fixture def login_page(page): 提供登录页面对象 return LoginPage(page) pytest.fixture def dashboard_page(page): 提供仪表板页面对象 return DashboardPage(page) pytest.fixture def test_user(): 提供测试用户数据 return {“username”: “standard_user”, “password”: “secret_sauce”}编写一个清晰的测试用例# tests/test_login.py import pytest import allure # 可选用于生成更漂亮的Allure报告 class TestLogin: pytest.mark.smoke pytest.mark.parametrize(“username, password, expected”, [ (“standard_user”, “secret_sauce”, “success”), (“locked_out_user”, “secret_sauce”, “error”), (“invalid_user”, “wrong_pass”, “error”), ]) def test_login_with_different_users(self, login_page, test_user, username, password, expected): 测试不同用户登录场景 # 1. 导航到登录页 login_page.navigate(“https://www.saucedemo.com/”) # 2. 执行登录操作 login_page.login(username, password) # 3. 断言结果 if expected “success”: # 验证登录成功例如跳转到dashboard页或出现欢迎语 assert login_page.page.url “https://www.saucedemo.com/inventory.html” assert login_page.page.is_visible(“textProducts”) else: # 验证出现错误提示 error_text login_page.get_error_message() assert error_text is not None assert “locked out” in error_text.lower() or “do not match” in error_text.lower()4.3 测试数据管理与数据驱动将测试数据与测试逻辑分离是保持用例整洁的关键。JSON/YAML文件存储静态测试数据。// fixtures/test_users.json [ {“role”: “admin”, “username”: “admin1”, “password”: “Admin123”, “expected”: “success”}, {“role”: “locked_user”, “username”: “locked1”, “password”: “pass”, “expected”: “locked_out”} ]Pytest的pytest.mark.parametrize适合参数化少量、简单的数据。外部数据库或API对于需要动态生成或获取的数据如订单号、用户ID。Faker库生成随机的、逼真的测试数据姓名、邮箱、地址等。4.4 报告生成与失败分析清晰的测试报告是自动化测试的价值体现。除了Pytest自带的-v和-s输出我们还可以集成更强大的报告工具。Pytest-HTML报告生成独立的HTML报告。pip install pytest-html pytest --htmlreports/report.html --self-contained-htmlAllure报告生成非常美观、交互性强的报告支持步骤、附件截图、日志、分类等。pip install allure-pytest # 运行测试并生成Allure结果数据 pytest --alluredir./allure-results # 生成并打开HTML报告 allure serve ./allure-results在测试用例中可以使用Allure装饰器增强报告import allure allure.feature(“登录模块”) allure.story(“用户登录成功”) def test_successful_login(login_page, test_user): with allure.step(“导航到登录页面”): login_page.navigate(“...”) with allure.step(“输入用户名和密码”): login_page.login(test_user[“username”], test_user[“password”]) with allure.step(“验证登录成功”): assert login_page.page.url.contains(“dashboard”)失败自动截图/录屏这是调试的利器。我们可以通过Pytest的钩子函数hook在测试失败时自动截图或保存录屏。# conftest.py import pytest from datetime import datetime pytest.hookimpl(hookwrapperTrue) def pytest_runtest_makereport(item, call): outcome yield report outcome.get_result() if report.when “call” and report.failed: # 获取测试用例中的page fixture page item.funcargs.get(“page”) if page: timestamp datetime.now().strftime(“%Y%m%d_%H%M%S”) screenshot_path f”./artifacts/screenshots/failure_{item.name}_{timestamp}.png” page.screenshot(pathscreenshot_path) # 将截图附件添加到Allure报告如果使用Allure if hasattr(report, “extra”): from allure_commons.types import AttachmentType import allure allure.attach( page.screenshot(), namef”failure_{item.name}”, attachment_typeAttachmentType.PNG ) print(f”\nTest failed. Screenshot saved to: {screenshot_path}”)4.5 集成到CI/CD流水线自动化测试只有集成到CI/CD中才能发挥最大价值。以下是一个GitHub Actions工作流的示例它会在每次代码推送或拉取请求时自动运行测试。# .github/workflows/playwright-tests.yml name: Playwright Tests on: [push, pull_request] jobs: test: timeout-minutes: 30 runs-on: ubuntu-latest steps: - uses: actions/checkoutv3 - name: Set up Python uses: actions/setup-pythonv4 with: python-version: ‘3.10’ - name: Install dependencies run: | pip install -r requirements.txt # 安装Playwright浏览器使用CI预装版本或自行安装 playwright install --with-deps chromium - name: Run tests run: | # 运行测试并生成Allure结果 pytest tests/ --alluredir./allure-results -v - name: Upload Allure report uses: actions/upload-artifactv3 if: always() # 即使测试失败也上传报告 with: name: allure-results path: ./allure-results/ # 可选将Allure报告发布到GitHub Pages或专用服务器 # - name: Deploy Allure Report # ...企业级实战技巧使用Docker将测试环境容器化确保在任何CI服务器上运行环境一致。Playwright官方提供了Docker镜像mcr.microsoft.com/playwright/python。并行执行利用Pytest的-n参数需要安装pytest-xdist或Playwright Test的并行特性大幅缩短测试套件执行时间。测试分级使用Pytest的mark功能对测试用例分级如pytest.mark.smoke,pytest.mark.regression在CI中根据需求运行不同级别的测试。环境配置使用python-dotenv管理不同环境开发、测试、预生产的配置如基础URL、账号密码等避免硬编码。5. 高级技巧与疑难问题排查即使框架搭好了在实际企业级应用中还是会遇到各种棘手问题。这里分享一些高级技巧和常见坑的解决方案。5.1 处理复杂场景Shadow DOM、Iframe与文件上传Shadow DOMPlaywright可以穿透Shadow DOM进行定位使用或/deep/组合子。# 假设有一个自定义元素 my-component page.locator(“my-component .internal-button”).click() # 或者使用Pierce选择器推荐 page.locator(“my-component”).locator(“.internal-button”).click()Iframe如前所述使用page.frame()或frame_locator()。# 通过name或URL定位iframe frame page.frame(name“my-iframe”) await frame.click(“button”) # 或者直接链式定位 page.frame_locator(“iframe[title‘editor’]”).locator(“textSave”).click()文件上传Playwright处理文件上传非常优雅无需模拟复杂的点击操作直接设置文件输入框的值即可。# input type“file” id“file-upload” page.set_input_files(“#file-upload”, “/path/to/my/file.pdf”) # 上传多个文件 page.set_input_files(“#file-upload”, [“file1.pdf”, “file2.jpg”]) # 清除已选文件 page.set_input_files(“#file-upload”, [])5.2 性能测试与追踪Playwright可以录制性能时间线Timeline Trace这对于分析页面加载性能、查找性能瓶颈非常有帮助。# 启动浏览器时开启追踪 browser await p.chromium.launch() context await browser.new_context() # 开始录制 await context.tracing.start(screenshotsTrue, snapshotsTrue) page await context.new_page() # ... 执行你的测试操作 ... # 停止录制并保存 await context.tracing.stop(path“trace.zip”)生成的trace.zip文件可以用Chrome DevTools的chrome://tracing或 Edge的edge://tracing工具打开进行可视化分析。5.3 常见问题排查清单问题现象可能原因排查步骤与解决方案元素找不到 (Locator not found)1. 元素尚未加载/出现。2. 定位器写法错误或元素属性已变更。3. 元素在iframe或Shadow DOM内。4. 页面有多个匹配元素。1. 使用page.wait_for_selector()显式等待。2. 使用浏览器开发者工具重新检查元素优先使用get_by_role/text/testid。3. 检查是否在iframe内使用frame_locator。4. 使用first,nth, 或更精确的选择器。点击/输入无效1. 元素被遮挡如弹窗、其他元素。2. 元素不可交互disabled, readonly。3. 页面发生了导航或刷新。1. 使用page.screenshot()查看当前页面状态。2. 检查元素状态page.is_enabled(),page.is_visible()。3. 在操作前等待页面稳定page.wait_for_load_state(‘networkidle’)。测试在CI上失败本地却成功1. CI环境与本地环境差异网络、资源、数据。2. 时间问题CI服务器性能差等待时间不足。3. 浏览器版本或驱动不一致。1. 增加通用等待时间使用page.set_default_timeout()。2. 在CI日志中查看失败时的截图和追踪文件。3. 确保CI使用与本地一致的Playwright版本和浏览器版本。使用Docker固化环境。页面响应慢超时1. 页面资源如图片、JS过大或阻塞。2. 后端API响应慢。3. 测试脚本中有不必要的等待。1. 使用page.route()拦截并阻止非必要资源如图片、样式表加载加速测试。2. 模拟网络条件context.set_offline()或使用慢速网络预设。3. 检查代码用更精确的等待替代固定的time.sleep()。被网站检测为自动化脚本一些网站会检测navigator.webdriver等属性。1. 启动上下文时添加ignore_default_args: [‘--enable-automation’]。2. 使用add_init_script注入脚本修改或删除某些属性。3. 使用非无头模式headless: false但CI上可能不适用。5.4 调试技巧非无头模式运行在调试时始终使用headless: False来观察浏览器实际行为。慢动作模式browser p.chromium.launch(headlessFalse, slow_mo1000)让每个操作延迟1秒方便观察。打开开发者工具browser p.chromium.launch(devtoolsTrue)。使用page.pause()在脚本中插入page.pause()运行时会打开Playwright Inspector你可以单步执行、查看定位器、实时修改代码是强大的交互式调试工具。善用日志启用Playwright的详细日志。# Bash DEBUGpw:api pytest your_test.py # 或在代码中设置环境变量 import os os.environ[“DEBUG”] “pw:api”从Selenium迁移到Playwright远不止是换一个库那么简单。它是一次测试理念的升级从与浏览器“艰难对话”到“无缝协作”。它带来的稳定性、开发体验和性能提升是实实在在的。迁移过程当然有学习成本可能需要重写一部分用例但长期来看维护成本的降低和测试可靠性的提升会让这笔投资非常值得。我个人在完成迁移后团队花在调试“诡异”的自动化失败上的时间减少了超过70%新用例的编写速度也快了一倍。如果你正在为Selenium的稳定性发愁或者正准备启动新的自动化项目那么现在就是开始尝试Playwright的最佳时机。
从Selenium到Playwright：现代Web自动化测试架构迁移与实战指南
发布时间：2026/7/1 21:02:39
1. 项目概述为什么是时候告别 Selenium拥抱 Playwright 了如果你是一名Web自动化测试工程师或者正在学习自动化测试那么“Selenium”这个名字对你来说一定如雷贯耳。它统治了这个领域超过十年是无数测试框架的基石。但最近一两年一个叫“Playwright”的新秀正在迅速崛起并且在很多技术社区和招聘要求中它的出现频率越来越高。我本人从Selenium 2.0时代开始用它做过无数项目也踩过无数的坑。直到去年在一个对稳定性和执行速度要求极高的企业级项目中我被迫全面转向Playwright这才发现我们可能真的到了一个技术栈更新的十字路口。这篇指南就是我基于这次彻底的技术迁移和后续多个实战项目的经验总结。它不是一篇简单的工具对比而是一份从“为什么换”到“怎么换”再到“如何用好”的完整路线图。我会带你深入理解Playwright的设计哲学手把手搭建从零到一的环境详解其核心API的现代用法并最终构建一个可复用的、健壮的企业级测试框架。你会发现Playwright解决的不仅仅是Selenium的“慢”和“不稳定”它更带来了一套全新的、面向现代Web应用的自动化思维。无论你是被Selenium的异步加载、动态元素折磨得焦头烂额的老手还是刚刚入门、不想在过时的技术上浪费时间的新人这篇文章都将为你提供一条清晰的进阶路径。2. Playwright 核心优势深度解析不止是“更快更稳”很多人初识Playwright听到的都是“它比Selenium快”、“它更稳定”。这没错但这些都是结果而非原因。要真正理解它的价值我们必须深入到其架构设计层面。2.1 架构革新从“翻译官”到“原生支持”Selenium WebDriver的核心工作模式是一个“翻译官”。你的测试脚本比如用Python写的通过WebDriver协议发送指令给一个浏览器驱动程序如ChromeDriver这个驱动程序再通过浏览器的调试协议如Chrome DevTools Protocol去控制浏览器。这个链条长任何一环的延迟或不稳定都会导致整个测试的脆弱。graph TD subgraph Selenium A[测试脚本 Python/Java] -- B[WebDriver 协议]; B -- C[浏览器驱动 ChromeDriver]; C -- D[浏览器调试协议 CDP]; D -- E[浏览器 Chrome]; end而Playwright则采取了“直连”模式。它由微软团队开发直接与Chromium、Firefox和WebKitSafari三大浏览器引擎的官方团队合作为每个浏览器都定制开发了一个专用的“Playwright驱动程序”。这个驱动程序直接内嵌了对浏览器自动化协议的原生、深度支持跳过了WebDriver这个中间层。这意味着更少的协议转换、更直接的命令执行和更丰富的控制能力。graph TD subgraph Playwright F[测试脚本 Node.js/Python/.NET/Java] -- G[Playwright 核心库]; G -- H[Playwright 专用驱动 for Chromium]; G -- I[Playwright 专用驱动 for Firefox]; G -- J[Playwright 专用驱动 for WebKit]; H -- K[浏览器 Chromium]; I -- L[浏览器 Firefox]; J -- M[浏览器 Safari]; end这种架构带来的直接好处就是速度和稳定性。命令执行更快因为链路更短稳定性更高因为Playwright团队可以针对每个浏览器的特性进行深度优化而不是依赖一个通用的、可能更新滞后的标准协议。2.2 自动等待告别显式等待的“智能”等待这可能是让Selenium用户幸福感提升最明显的一点。在Selenium中处理动态加载的元素是一场噩梦。你必须到处写WebDriverWait并精心设计等待条件expected_conditions一个不小心就会因为元素未加载而抛出NoSuchElementException或TimeoutException。Playwright内置了“自动等待”机制。它的绝大多数操作如click,fill,text_content在执行前都会自动等待目标元素满足一系列可操作性条件元素被附加到DOM中、可见、未被禁用、稳定没有动画等。这意味着在绝大多数情况下你只需要写page.click(‘button#submit’)Playwright会帮你等到这个按钮真正可以点击时才去点击。# Selenium 方式必须显式等待 from selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC from selenium.webdriver.common.by import By element WebDriverWait(driver, 10).until( EC.element_to_be_clickable((By.ID, “submit”)) ) element.click() # Playwright 方式自动等待 page.click(“button#submit”) # 这一行代码等价于上面Selenium的所有代码当然自动等待不是万能的。对于某些非标准的加载状态比如等待某个特定网络请求完成你仍然需要使用page.wait_for_function()或page.wait_for_event()等方法。但日常90%的等待场景都被覆盖了代码简洁度和可维护性有了质的飞跃。2.3 多上下文与多页面模拟真实用户场景的利器现代Web应用大量使用多标签页、弹出窗口、Iframe。Selenium对此的支持比较笨拙需要手动切换句柄window_handles代码容易混乱。Playwright引入了BrowserContext的概念。你可以把它理解为一个独立的、隔离的浏览器会话。每个Context拥有独立的cookie、localStorage、会话历史就像你用浏览器的“无痕模式”新开了一个窗口。在一个Browser实例下你可以创建多个Context在每个Context里又可以打开多个Page标签页。这种模型非常清晰地映射了真实用户的使用模式。import asyncio from playwright.async_api import async_playwright async def main(): async with async_playwright() as p: browser await p.chromium.launch(headlessFalse) # 创建两个独立的上下文如模拟两个用户 context1 await browser.new_context() context2 await browser.new_context() # 在每个上下文中打开页面 page1 await context1.new_page() page2 await context2.new_page() # page1和page2完全隔离cookie互不影响 await page1.goto(“https://example.com/login”) await page1.fill(“#username”, “user1”) # ... await page2.goto(“https://example.com/login”) await page2.fill(“#username”, “user2”) # 可以同时登录不同账号 # ... await browser.close() asyncio.run(main())这个特性对于测试需要登录态隔离、并行执行不同用户场景的用例来说简直是神器。管理Iframe也变得异常简单page.frame(“frame-name”)或page.frame_locator(“iframe”).locator(“button”)直接定位无需切换。2.4 强大的网络拦截与模拟Playwright允许你监听和修改页面发出的任何网络请求这为测试提供了前所未有的灵活性。拦截请求你可以阻止某些请求比如阻止广告或跟踪脚本加载或者修改请求头、请求体。模拟响应你可以直接为特定的URL模式返回一个自定义的响应而无需经过真实服务器。这在测试边缘场景如服务器错误、慢速网络或依赖第三方不可控API时非常有用。等待请求可以等待某个特定请求发出并完成这对于测试依赖于AJAX操作的交互至关重要。# 拦截并修改请求 await page.route(“**/*.{png,jpg,jpeg}”, lambda route: route.abort()) # 阻止图片加载加速测试 # 模拟API响应 await page.route(“**/api/user”, lambda route: route.fulfill( status200, content_type“application/json”, bodyjson.dumps({“name”: “Mock User”, “id”: 123}) )) # 等待请求完成 async with page.expect_request(“**/api/submit”) as request_info: await page.click(“#submit-btn”) request await request_info.value print(request.url, request.method)2.5 原生移动端模拟与代码生成器Playwright支持直接模拟移动设备如iPhone、Pixel的视口、User-Agent、触摸事件等无需启动复杂的模拟器或真机。结合多浏览器支持一套脚本可以轻松覆盖桌面端和移动端的响应式测试。此外Playwright内置的代码生成器playwright codegen是快速上手和编写脚本的利器。你只需在命令行启动它然后像普通用户一样操作浏览器它就会实时生成对应操作的代码支持Python、Java、C#、JavaScript大大提升了编写测试用例的效率尤其适合为已有功能快速生成测试骨架。3. 从零开始Playwright 环境搭建与核心API精讲理论说得再多不如动手实践。让我们从安装开始一步步掌握Playwright的核心用法。3.1 环境安装与初始化Playwright支持多种语言但以其原生支持Node.js和Python版本最为流行和成熟。这里以Python为例。# 1. 使用pip安装playwright库 pip install playwright # 2. 安装Playwright所需的浏览器二进制文件Chromium, Firefox, WebKit playwright install注意playwright install会下载所有三个浏览器的稳定版本这可能需要一些时间和磁盘空间约1.5GB。如果只想安装特定浏览器可以使用playwright install chromium。在企业内网环境可能需要配置代理或使用离线安装包。安装完成后一个最简单的脚本如下from playwright.sync_api import sync_playwright def run(): with sync_playwright() as p: # 启动浏览器headlessFalse表示显示UI browser p.chromium.launch(headlessFalse) # 创建页面上下文和页面 page browser.new_page() # 导航到网址 page.goto(“https://www.example.com”) # 截图 page.screenshot(path“example.png”) # 关闭浏览器 browser.close() if __name__ “__main__”: run()3.2 元素定位与操作告别XPath地狱Playwright提供了多种强大且稳定的定位器Locator。最佳实践是优先使用面向用户的定位器Role, Text其次是Test ID尽量避免使用脆弱的XPath或CSS选择器。按角色和文本定位最推荐这是最接近用户视角的方式可读性高对前端代码改动不敏感。# 点击一个名为“登录”的按钮 page.get_by_role(“button”, name“登录”).click() # 填写一个标签为“用户名”的输入框 page.get_by_label(“用户名”).fill(“myuser”) # 点击包含特定文本的元素 page.get_by_text(“Welcome back”).click()使用测试IDTest ID这是与开发协作的最佳方式。让开发在关键元素上添加>!-- 前端代码 -- button># 测试脚本 page.get_by_test_id(“login-submit-btn”).click()CSS和XPath定位在以上方法不适用时使用。Playwright的locator()方法接受CSS选择器或XPath。page.locator(“#search-input”).fill(“query”) page.locator(“//button[contains(class, ‘primary’)]”).click()实操心得尽量避免使用过于复杂或依赖绝对路径的XPath。它们极其脆弱前端一个简单的div嵌套变动就可能导致定位失败。CSS选择器通常比XPath性能更好也更简洁。元素操作非常简单直观并且内置自动等待# 输入文本 page.locator(“#email”).fill(“testexample.com”) # 点击 page.locator(“button:has-text(‘Submit’)”).click() # 获取文本 text page.locator(“.status-message”).text_content() # 获取属性值 href page.locator(“a.link”).get_attribute(“href”) # 勾选复选框 page.locator(“#agree-terms”).check() # 选择下拉框选项 page.locator(“#country”).select_option(“CN”)3.3 处理弹窗、对话框和下载Playwright对浏览器原生对话框alert, confirm, prompt的处理是监听事件而非在对话框弹出后操作。# 监听并接受confirm对话框 page.on(“dialog”, lambda dialog: dialog.accept()) page.click(“button#delete”) # 点击会触发confirm的按钮 # 更精确的控制 def handle_dialog(dialog): print(dialog.message) if “confirm” in dialog.message: dialog.accept() else: dialog.dismiss() page.on(“dialog”, handle_dialog)处理文件下载也非常优雅# 等待下载事件 async with page.expect_download() as download_info: page.click(“a#download-link”) download await download_info.value # 获取下载文件路径或保存到指定位置 path await download.path() await download.save_as(“/path/to/save/file.pdf”)3.4 异步Async与同步SyncAPIPlaywright原生是基于异步IONode.js设计的但也为Python、Java、C#提供了友好的同步API封装。选择哪个取决于你的项目和技术栈。异步API性能更高适合I/O密集型操作和高并发测试场景。使用async/await语法。from playwright.async_api import async_playwright import asyncio async def main(): async with async_playwright() as p: browser await p.chromium.launch() page await browser.new_page() await page.goto(“https://example.com”) # ... 其他异步操作 await browser.close() asyncio.run(main())同步API写法更简单直观类似于传统的Selenium脚本适合线性脚本或初学者。使用sync_playwright。from playwright.sync_api import sync_playwright with sync_playwright() as p: browser p.chromium.launch() page browser.new_page() page.goto(“https://example.com”) # ... 其他同步操作 browser.close()注意事项如果你在像pytest这样的测试框架中混用异步和同步代码需要小心处理事件循环。通常建议在一个项目内保持一致风格。对于复杂的、需要并行操作多个页面的测试异步API优势明显。4. 构建企业级测试框架从用例编写到CI/CD集成掌握了核心API我们就可以着手搭建一个健壮、可维护、可扩展的测试框架了。一个好的框架能提升团队效率降低维护成本。4.1 项目结构与设计模式一个典型的企业级Playwright测试项目结构如下my-automation-framework/ ├── conftest.py # Pytest全局配置、Fixture定义 ├── pytest.ini # Pytest配置文件 ├── requirements.txt # Python依赖 ├── playwright.config.ts/js # Playwright Test专用配置如使用PW Test ├── pages/ # 页面对象模型Page Object Model │ ├── __init__.py │ ├── base_page.py # 基础页面类 │ ├── login_page.py │ └── dashboard_page.py ├── locators/ # 定位器集中管理可选 │ ├── login_locators.py │ └── ... ├── tests/ # 测试用例 │ ├── __init__.py │ ├── test_login.py │ ├── test_dashboard.py │ └── smoke_tests/ ├── fixtures/ # 测试数据夹具 │ └── test_data.json ├── utils/ # 工具函数 │ ├── api_client.py │ ├── logger.py │ └── helpers.py ├── reports/ # 测试报告输出目录 └── artifacts/ # 临时文件、截图、录屏通常由工具自动生成核心设计模式页面对象模型Page Object Model, POMPOM是UI自动化测试的黄金标准。它将页面的元素定位和操作封装成类测试用例只关心业务逻辑不与具体的HTML结构耦合。# pages/base_page.py from playwright.sync_api import Page class BasePage: def __init__(self, page: Page): self.page page self.timeout 30000 def navigate(self, url): self.page.goto(url) def take_screenshot(self, name): self.page.screenshot(pathf”./screenshots/{name}.png”) # pages/login_page.py from .base_page import BasePage class LoginPage(BasePage): # 定位器作为类属性 USERNAME_INPUT “#username” PASSWORD_INPUT “#password” LOGIN_BUTTON “button[type‘submit’]” ERROR_MSG “.alert-error” def __init__(self, page: Page): super().__init__(page) def login(self, username: str, password: str): 登录操作 self.page.fill(self.USERNAME_INPUT, username) self.page.fill(self.PASSWORD_INPUT, password) self.page.click(self.LOGIN_BUTTON) def get_error_message(self) - str: 获取错误信息 return self.page.text_content(self.ERROR_MSG)4.2 使用Pytest进行测试组织与Fixture管理Pytest是Python生态中最强大的测试框架与Playwright结合得天衣无缝。我们可以利用Pytest的Fixture来管理浏览器、页面上下文和测试数据。# conftest.py import pytest from playwright.sync_api import Page, BrowserContext, Browser from pages.login_page import LoginPage from pages.dashboard_page import DashboardPage pytest.fixture(scope“session”) def browser(): 启动浏览器实例整个测试会话只启动一次 from playwright.sync_api import sync_playwright with sync_playwright() as p: # 可以在这里配置启动参数如无头模式、窗口大小、代理等 browser p.chromium.launch(headlessTrue, args[“--start-maximized”]) yield browser browser.close() pytest.fixture def context(browser): 为每个测试用例创建一个独立的浏览器上下文 context browser.new_context( viewport{‘width’: 1920, ‘height’: 1080}, ignore_https_errorsTrue # 忽略HTTPS证书错误用于测试环境 ) yield context context.close() pytest.fixture def page(context): 为每个测试用例提供一个干净的页面 page context.new_page() yield page page.close() pytest.fixture def login_page(page): 提供登录页面对象 return LoginPage(page) pytest.fixture def dashboard_page(page): 提供仪表板页面对象 return DashboardPage(page) pytest.fixture def test_user(): 提供测试用户数据 return {“username”: “standard_user”, “password”: “secret_sauce”}编写一个清晰的测试用例# tests/test_login.py import pytest import allure # 可选用于生成更漂亮的Allure报告 class TestLogin: pytest.mark.smoke pytest.mark.parametrize(“username, password, expected”, [ (“standard_user”, “secret_sauce”, “success”), (“locked_out_user”, “secret_sauce”, “error”), (“invalid_user”, “wrong_pass”, “error”), ]) def test_login_with_different_users(self, login_page, test_user, username, password, expected): 测试不同用户登录场景 # 1. 导航到登录页 login_page.navigate(“https://www.saucedemo.com/”) # 2. 执行登录操作 login_page.login(username, password) # 3. 断言结果 if expected “success”: # 验证登录成功例如跳转到dashboard页或出现欢迎语 assert login_page.page.url “https://www.saucedemo.com/inventory.html” assert login_page.page.is_visible(“textProducts”) else: # 验证出现错误提示 error_text login_page.get_error_message() assert error_text is not None assert “locked out” in error_text.lower() or “do not match” in error_text.lower()4.3 测试数据管理与数据驱动将测试数据与测试逻辑分离是保持用例整洁的关键。JSON/YAML文件存储静态测试数据。// fixtures/test_users.json [ {“role”: “admin”, “username”: “admin1”, “password”: “Admin123”, “expected”: “success”}, {“role”: “locked_user”, “username”: “locked1”, “password”: “pass”, “expected”: “locked_out”} ]Pytest的pytest.mark.parametrize适合参数化少量、简单的数据。外部数据库或API对于需要动态生成或获取的数据如订单号、用户ID。Faker库生成随机的、逼真的测试数据姓名、邮箱、地址等。4.4 报告生成与失败分析清晰的测试报告是自动化测试的价值体现。除了Pytest自带的-v和-s输出我们还可以集成更强大的报告工具。Pytest-HTML报告生成独立的HTML报告。pip install pytest-html pytest --htmlreports/report.html --self-contained-htmlAllure报告生成非常美观、交互性强的报告支持步骤、附件截图、日志、分类等。pip install allure-pytest # 运行测试并生成Allure结果数据 pytest --alluredir./allure-results # 生成并打开HTML报告 allure serve ./allure-results在测试用例中可以使用Allure装饰器增强报告import allure allure.feature(“登录模块”) allure.story(“用户登录成功”) def test_successful_login(login_page, test_user): with allure.step(“导航到登录页面”): login_page.navigate(“...”) with allure.step(“输入用户名和密码”): login_page.login(test_user[“username”], test_user[“password”]) with allure.step(“验证登录成功”): assert login_page.page.url.contains(“dashboard”)失败自动截图/录屏这是调试的利器。我们可以通过Pytest的钩子函数hook在测试失败时自动截图或保存录屏。# conftest.py import pytest from datetime import datetime pytest.hookimpl(hookwrapperTrue) def pytest_runtest_makereport(item, call): outcome yield report outcome.get_result() if report.when “call” and report.failed: # 获取测试用例中的page fixture page item.funcargs.get(“page”) if page: timestamp datetime.now().strftime(“%Y%m%d_%H%M%S”) screenshot_path f”./artifacts/screenshots/failure_{item.name}_{timestamp}.png” page.screenshot(pathscreenshot_path) # 将截图附件添加到Allure报告如果使用Allure if hasattr(report, “extra”): from allure_commons.types import AttachmentType import allure allure.attach( page.screenshot(), namef”failure_{item.name}”, attachment_typeAttachmentType.PNG ) print(f”\nTest failed. Screenshot saved to: {screenshot_path}”)4.5 集成到CI/CD流水线自动化测试只有集成到CI/CD中才能发挥最大价值。以下是一个GitHub Actions工作流的示例它会在每次代码推送或拉取请求时自动运行测试。# .github/workflows/playwright-tests.yml name: Playwright Tests on: [push, pull_request] jobs: test: timeout-minutes: 30 runs-on: ubuntu-latest steps: - uses: actions/checkoutv3 - name: Set up Python uses: actions/setup-pythonv4 with: python-version: ‘3.10’ - name: Install dependencies run: | pip install -r requirements.txt # 安装Playwright浏览器使用CI预装版本或自行安装 playwright install --with-deps chromium - name: Run tests run: | # 运行测试并生成Allure结果 pytest tests/ --alluredir./allure-results -v - name: Upload Allure report uses: actions/upload-artifactv3 if: always() # 即使测试失败也上传报告 with: name: allure-results path: ./allure-results/ # 可选将Allure报告发布到GitHub Pages或专用服务器 # - name: Deploy Allure Report # ...企业级实战技巧使用Docker将测试环境容器化确保在任何CI服务器上运行环境一致。Playwright官方提供了Docker镜像mcr.microsoft.com/playwright/python。并行执行利用Pytest的-n参数需要安装pytest-xdist或Playwright Test的并行特性大幅缩短测试套件执行时间。测试分级使用Pytest的mark功能对测试用例分级如pytest.mark.smoke,pytest.mark.regression在CI中根据需求运行不同级别的测试。环境配置使用python-dotenv管理不同环境开发、测试、预生产的配置如基础URL、账号密码等避免硬编码。5. 高级技巧与疑难问题排查即使框架搭好了在实际企业级应用中还是会遇到各种棘手问题。这里分享一些高级技巧和常见坑的解决方案。5.1 处理复杂场景Shadow DOM、Iframe与文件上传Shadow DOMPlaywright可以穿透Shadow DOM进行定位使用或/deep/组合子。# 假设有一个自定义元素 my-component page.locator(“my-component .internal-button”).click() # 或者使用Pierce选择器推荐 page.locator(“my-component”).locator(“.internal-button”).click()Iframe如前所述使用page.frame()或frame_locator()。# 通过name或URL定位iframe frame page.frame(name“my-iframe”) await frame.click(“button”) # 或者直接链式定位 page.frame_locator(“iframe[title‘editor’]”).locator(“textSave”).click()文件上传Playwright处理文件上传非常优雅无需模拟复杂的点击操作直接设置文件输入框的值即可。# input type“file” id“file-upload” page.set_input_files(“#file-upload”, “/path/to/my/file.pdf”) # 上传多个文件 page.set_input_files(“#file-upload”, [“file1.pdf”, “file2.jpg”]) # 清除已选文件 page.set_input_files(“#file-upload”, [])5.2 性能测试与追踪Playwright可以录制性能时间线Timeline Trace这对于分析页面加载性能、查找性能瓶颈非常有帮助。# 启动浏览器时开启追踪 browser await p.chromium.launch() context await browser.new_context() # 开始录制 await context.tracing.start(screenshotsTrue, snapshotsTrue) page await context.new_page() # ... 执行你的测试操作 ... # 停止录制并保存 await context.tracing.stop(path“trace.zip”)生成的trace.zip文件可以用Chrome DevTools的chrome://tracing或 Edge的edge://tracing工具打开进行可视化分析。5.3 常见问题排查清单问题现象可能原因排查步骤与解决方案元素找不到 (Locator not found)1. 元素尚未加载/出现。2. 定位器写法错误或元素属性已变更。3. 元素在iframe或Shadow DOM内。4. 页面有多个匹配元素。1. 使用page.wait_for_selector()显式等待。2. 使用浏览器开发者工具重新检查元素优先使用get_by_role/text/testid。3. 检查是否在iframe内使用frame_locator。4. 使用first,nth, 或更精确的选择器。点击/输入无效1. 元素被遮挡如弹窗、其他元素。2. 元素不可交互disabled, readonly。3. 页面发生了导航或刷新。1. 使用page.screenshot()查看当前页面状态。2. 检查元素状态page.is_enabled(),page.is_visible()。3. 在操作前等待页面稳定page.wait_for_load_state(‘networkidle’)。测试在CI上失败本地却成功1. CI环境与本地环境差异网络、资源、数据。2. 时间问题CI服务器性能差等待时间不足。3. 浏览器版本或驱动不一致。1. 增加通用等待时间使用page.set_default_timeout()。2. 在CI日志中查看失败时的截图和追踪文件。3. 确保CI使用与本地一致的Playwright版本和浏览器版本。使用Docker固化环境。页面响应慢超时1. 页面资源如图片、JS过大或阻塞。2. 后端API响应慢。3. 测试脚本中有不必要的等待。1. 使用page.route()拦截并阻止非必要资源如图片、样式表加载加速测试。2. 模拟网络条件context.set_offline()或使用慢速网络预设。3. 检查代码用更精确的等待替代固定的time.sleep()。被网站检测为自动化脚本一些网站会检测navigator.webdriver等属性。1. 启动上下文时添加ignore_default_args: [‘--enable-automation’]。2. 使用add_init_script注入脚本修改或删除某些属性。3. 使用非无头模式headless: false但CI上可能不适用。5.4 调试技巧非无头模式运行在调试时始终使用headless: False来观察浏览器实际行为。慢动作模式browser p.chromium.launch(headlessFalse, slow_mo1000)让每个操作延迟1秒方便观察。打开开发者工具browser p.chromium.launch(devtoolsTrue)。使用page.pause()在脚本中插入page.pause()运行时会打开Playwright Inspector你可以单步执行、查看定位器、实时修改代码是强大的交互式调试工具。善用日志启用Playwright的详细日志。# Bash DEBUGpw:api pytest your_test.py # 或在代码中设置环境变量 import os os.environ[“DEBUG”] “pw:api”从Selenium迁移到Playwright远不止是换一个库那么简单。它是一次测试理念的升级从与浏览器“艰难对话”到“无缝协作”。它带来的稳定性、开发体验和性能提升是实实在在的。迁移过程当然有学习成本可能需要重写一部分用例但长期来看维护成本的降低和测试可靠性的提升会让这笔投资非常值得。我个人在完成迁移后团队花在调试“诡异”的自动化失败上的时间减少了超过70%新用例的编写速度也快了一倍。如果你正在为Selenium的稳定性发愁或者正准备启动新的自动化项目那么现在就是开始尝试Playwright的最佳时机。
![华为OD机试2025C卷-字符串变换最小次数[100分]（ Java _ Python3 _ C++ _ C语言 _ JsNode _ Go）实现100%通过率](http://pic.xiahunao.cn/yaotu/华为OD机试2025C卷-字符串变换最小次数[100分]（ Java _ Python3 _ C++ _ C语言 _ JsNode _ Go）实现100%通过率)
![华为OD机试2025C卷-内存资源分配[100分]（ Java _ Python3 _ C++ _ C语言 _ JsNode _ Go）实现100%通过率](http://pic.xiahunao.cn/yaotu/华为OD机试2025C卷-内存资源分配[100分]（ Java _ Python3 _ C++ _ C语言 _ JsNode _ Go）实现100%通过率)
