Playwright沙箱模式实战：构建高隔离度的浏览器自动化测试环境

1. 项目概述：为什么我们需要沙箱模式？

在浏览器自动化测试的世界里，我们常常面临一个两难困境：一方面，我们希望测试脚本能像真实用户一样，与浏览器进行深度交互，包括访问本地文件、执行复杂JavaScript、甚至调用一些系统级API；另一方面，我们又必须将这种强大的能力限制在一个可控的“笼子”里，防止测试脚本的异常行为污染主系统、泄露敏感数据，或者因为一个测试用例的崩溃而“株连”整个测试套件。这就是“沙箱模式”要解决的核心问题。

我见过太多因为环境隔离不彻底而引发的“血案”。比如，一个测试脚本在清理测试数据时，误删了开发环境的本地配置文件；又或者，一个用于测试文件上传功能的用例，不小心将恶意脚本写入了系统临时目录，影响了后续所有测试的执行。更常见的是，并行测试时，多个测试实例共享了浏览器缓存、Cookie或LocalStorage，导致测试结果相互干扰，变得不可靠。这些问题，本质上都是测试环境“不干净”、不隔离造成的。

Playwright，作为现代浏览器自动化工具的后起之秀，其设计哲学之一就是“开箱即用的可靠性”。它原生支持多种强大的隔离机制，而“沙箱模式”正是其中最关键、也最容易被忽视的一环。它不仅仅是一个启动参数（--no-sandbox的反面），更是一套从进程、用户数据、网络到执行上下文的完整隔离策略。通过实战配置沙箱，我们能构建出一个个原子化的、自包含的测试环境，每个测试用例都像是在一个全新的、纯净的虚拟机中运行，互不干扰。这不仅提升了测试的稳定性和可重复性，更是安全实践的基石。

接下来，我将从一个资深测试开发的角度，带你彻底拆解Playwright沙箱模式的实战应用。我会分享如何从零配置一个高隔离度的测试环境，剖析其背后的技术原理，并提供一套可直接复用的完整代码模板。无论你是想提升现有测试套件的稳定性，还是正在设计一个新的自动化测试框架，这篇文章都能给你带来实实在在的干货。

2. 沙箱模式的核心原理与Playwright的隔离体系

要玩转沙箱，首先得明白它到底隔离了什么。很多人以为沙箱就是让浏览器跑在一个受限的进程里，这其实只对了一部分。Playwright（以及其驱动的浏览器）实现的隔离是一个多层次、立体化的防御体系。

2.1 进程隔离：最基础的防火墙

这是最直观的一层。当Playwright启动浏览器（如Chromium）时，默认情况下，浏览器的主进程、渲染进程、GPU进程等都是独立的系统进程。Playwright通过其自带的浏览器发行版，可以精确控制这些进程的启动参数。在沙箱模式下，关键的渲染进程会被放置在一个由操作系统内核支持的沙箱环境中（例如，在Linux上使用seccomp-bpf，在Windows上使用Job Objects和Win32k Lockdown）。

这意味着什么呢？意味着即使测试脚本通过浏览器渲染引擎的漏洞注入了一段恶意代码，这段代码也很难突破沙箱进程的边界，去执行诸如读写任意文件、访问其他进程内存等危险操作。它被限制在了一个极小的权限集合内。你在启动浏览器时，如果为了省事或解决某些启动错误而添加了--no-sandbox参数，就等于亲手拆掉了这堵最重要的防火墙。我的第一条实操心得就是：除非你百分之百确定你的测试环境绝对安全且别无他法，否则永远不要使用--no-sandbox。大部分启动问题，可以通过正确安装依赖、使用Playwright自带的浏览器来解决。

2.2 用户数据目录隔离：独立的“用户空间”

每个浏览器实例都有一个“用户数据目录”（User Data Directory），里面存储了缓存、Cookie、本地存储数据（LocalStorage、IndexedDB）、历史记录、扩展程序等。如果多个测试用例共享同一个目录，那么用例A设置的Cookie可能会被用例B读到，用例C清理的缓存可能会影响用例D的加载速度。

Playwright的BrowserContext（浏览器上下文）API，是解决这个问题的利器。你可以把它想象成一个独立的“隐身模式”会话的超级加强版。每个BrowserContext都拥有完全独立的用户数据目录，互不共享。

import asyncio from playwright.async_api import async_playwright async def main(): async with async_playwright() as p: # 启动一个浏览器实例 browser = await p.chromium.launch() # 创建两个完全隔离的浏览器上下文 context1 = await browser.new_context() context2 = await browser.new_context() # 在两个上下文中分别打开页面 page1 = await context1.new_page() page2 = await context2.new_page() # 在page1中设置一个Cookie await context1.add_cookies([{'name': 'session', 'value': 'user1_data', 'domain': 'example.com', 'path': '/'}]) # page2中绝对读取不到page1设置的Cookie cookies_in_page2 = await context2.cookies() print(f"Cookies in context2: {cookies_in_page2}") # 输出: [] await browser.close() asyncio.run(main())

通过为每个测试用例甚至每个测试步骤创建独立的BrowserContext，你可以确保状态不会泄漏。这是实现测试原子化的核心手段。

2.3 网络隔离与模拟

沙箱环境也意味着对网络行为的控制。Playwright允许你在BrowserContext级别进行网络拦截和模拟。

• 拦截请求/响应：你可以修改任何请求的URL、头信息、方法，或者直接返回一个模拟的响应，而不触及真实后端。这对于测试错误场景、第三方服务不可用等情况至关重要。
• 模拟网络条件：可以模拟2G、3G、Wi-Fi等不同网络环境下的速度和不稳定性，测试应用的弱网表现。
• 独立的HTTP认证和代理：每个上下文可以配置不同的代理服务器和HTTP认证凭据。

这种网络层面的隔离和控制，使得你可以创建出一个完全可控的“虚拟网络环境”供测试使用，不受外界真实网络波动和服务变更的影响。

2.4 JavaScript执行环境隔离

Playwright 可以在页面中执行任意 JavaScript 代码。在沙箱理念下，我们需要考虑这些代码的执行安全性。Playwright 本身并不提供一个类似vm2的纯 JavaScript 沙箱，但它通过以下方式降低风险：

1. 代码仅在目标页面上下文中执行：通过page.evaluate()注入的代码，其影响范围被限定在该页面内。
2. 与Node.js环境隔离：Playwright 的page.evaluate()中运行的代码无法直接访问 Node.js 的fs、path等模块，这天然形成了一层隔离。
3. 可控的暴露：如果你确实需要让页面脚本访问一些测试辅助函数，可以通过browser_context.expose_binding或browser_context.expose_function有选择地、安全地暴露有限的API给页面，而不是开放整个环境。

理解了这个多层次的隔离体系，我们就能有的放矢地配置我们的安全测试环境了。

3. 实战配置：构建高隔离度的Playwright测试环境

理论说再多，不如一行代码。下面，我将一步步展示如何配置一个从进程、数据到网络都充分隔离的 Playwright 测试环境。我们将使用 Pytest 作为测试框架，因为它与 Playwright 的集成非常出色。

3.1 环境搭建与基础配置

首先，确保你的项目已经初始化并安装了必要的依赖。

# 初始化项目（如果尚未） mkdir playwright-sandbox-demo && cd playwright-sandbox-demo python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate # 安装核心依赖 pip install pytest playwright # 安装Playwright的浏览器内核（建议使用默认的，以确保沙箱特性完整） playwright install chromium

接下来，创建conftest.py文件。这是 Pytest 的本地插件文件，我们将在这里定义全局的、安全的浏览器和上下文配置。

# conftest.py import pytest from playwright.sync_api import Page, BrowserContext, Browser from typing import Generator @pytest.fixture(scope="session") def browser(pytestconfig) -> Generator[Browser, None, None]: """ 会话级别的浏览器实例。 使用持久化上下文模式，并强制启用沙箱。 """ from playwright.sync_api import sync_playwright with sync_playwright() as p: # 关键配置：启动浏览器，启用沙箱（默认就是True，这里显式声明以示重要） # 额外添加一些安全强化参数 browser = p.chromium.launch( headless=False, # 调试时可设为False，观察浏览器行为 args=[ '--disable-dev-shm-usage', # 防止在Docker等受限环境中共享内存问题 '--disable-gpu', # 在无头模式或某些虚拟环境中禁用GPU '--disable-setuid-sandbox', # 在非root用户下禁用setuid沙箱（Docker常用） '--no-zygote', # 禁用zygote进程，提升启动速度，增强隔离 # 注意：我们没有使用 `--no-sandbox`！ ] ) yield browser browser.close() @pytest.fixture(scope="function") def context(browser: Browser, tmp_path) -> Generator[BrowserContext, None, None]: """ 函数（测试用例）级别的浏览器上下文。 每个测试用例都会获得一个全新的、隔离的上下文。 """ # 为每个上下文创建唯一的、临时的用户数据目录 user_data_dir = tmp_path / "playwright_context" user_data_dir.mkdir(exist_ok=True) # 创建上下文，配置隔离选项 context = browser.new_context( # 使用临时目录，测试结束后自动清理 user_data_dir=str(user_data_dir), # 视情况忽略HTTPS错误（仅测试环境建议，生产慎用） ignore_https_errors=True, # 设置一个默认的视口，确保一致性 viewport={'width': 1920, 'height': 1080}, # 可以在这里设置全局的请求超时等 # extra_http_headers={'X-Test-Env': 'sandboxed'} ) # 授予上下文必要的权限（例如地理位置、通知），如果需要测试这些功能 # context.grant_permissions(['geolocation']) yield context # 测试结束后，关闭上下文，清理相关资源 context.close() @pytest.fixture(scope="function") def page(context: BrowserContext) -> Generator[Page, None, None]: """ 函数级别的页面对象。 基于隔离的上下文创建。 """ page = context.new_page() yield page page.close()

配置解析与避坑指南：

1. browser夹具 (scope="session"): 浏览器进程的启动和关闭开销较大，因此在整个测试会话中只启动一次。所有测试用例共享同一个浏览器进程，但通过不同的上下文实现隔离。这平衡了性能与隔离性。
2. context夹具 (scope="function"): 这是隔离的核心。每个测试用例都有一个全新的BrowserContext。我们使用tmp_path（Pytest提供的临时目录夹具）来为每个上下文创建唯一的用户数据目录。测试结束后，Pytest会自动清理这个临时目录，确保没有残留数据。
3. page夹具 (scope="function"): 在每个上下文中创建一个新的页面。通常一个测试用例主要和一个页面交互。
4. 启动参数详解:
   • --disable-dev-shm-usage: 在Docker或内存受限的环境中，/dev/shm可能太小，导致Chrome崩溃。添加此参数使用/tmp替代。
   • --disable-gpu: 在无头模式或某些虚拟化/容器环境中，GPU加速可能导致问题，禁用它可以增加稳定性。
   • --disable-setuid-sandbox: 在Docker容器内（通常以非root用户运行）或某些不允许setuid的系统上，需要此参数来禁用一种沙箱机制，但浏览器自身的沙箱（渲染器沙箱）依然有效。这与--no-sandbox有本质区别。
   • --no-zygote: 在Linux上，Chromium默认使用zygote进程来快速孵化渲染进程。禁用它可以获得更彻底的进程隔离，轻微提升启动速度。
5. 重要警告: 如果你在CI/CD环境（如Docker容器）中遇到浏览器无法启动的问题，错误信息可能提示需要--no-sandbox。请首先尝试上述参数组合，并确保容器以非root用户运行。将--no-sandbox作为最后的手段，并充分评估安全风险。

3.2 编写高隔离度的测试用例

有了这些基础夹具，编写测试用例就变得非常清晰和安全了。

# test_sandboxed_features.py def test_cookie_isolation(page: Page): """测试Cookie在不同上下文/用例间的隔离""" # 用例1：在页面A设置Cookie await page.goto('https://httpbin.org/cookies/set?name=valueA') # 验证Cookie已设置 cookies = await page.context.cookies() assert any(c['name'] == 'name' and c['value'] == 'valueA' for c in cookies) # 注意：这个Cookie只存在于当前测试用例的`page.context`中。 # 下一个测试用例的上下文是全新的，绝对看不到这个Cookie。 def test_local_storage_isolation(page: Page): """测试LocalStorage的隔离""" await page.goto('data:text/html,<html></html>') # 一个空白页 # 在当前页面的上下文中设置LocalStorage await page.evaluate('() => { localStorage.setItem("secret", "data_from_test_2"); }') value = await page.evaluate('() => localStorage.getItem("secret")') assert value == 'data_from_test_2' # 这个数据不会污染其他测试用例 def test_network_interception_and_isolation(page: Page): """测试网络拦截与隔离：模拟一个API失败场景""" # 在当前页面的上下文中拦截请求 await page.route('**/api/user', lambda route: route.abort()) await page.goto('https://my-test-app.com') # 点击一个会调用 /api/user 的按钮 await page.click('#fetch-user-button') # 验证因为请求被中止，页面显示了错误状态 await page.wait_for_selector('.error-message') assert await page.is_visible('.error-message') # 这个拦截规则只对当前上下文生效，不会影响其他测试中的网络请求

每个测试用例都使用独立的page，背后是独立的context和user_data_dir。这样，测试用例之间达到了原子级的隔离。

4. 高级隔离策略与安全加固

基础隔离搭建好后，我们可以针对更复杂或更敏感的场景进行加固。

4.1 使用持久化上下文实现登录态隔离

有时我们需要测试登录后的功能，但又不希望每次测试都走一遍完整的登录流程（耗时且可能触发风控）。这时，我们可以为“已登录”和“未登录”这两种状态分别创建持久化的浏览器上下文。

# conftest.py 中追加或修改 import json from pathlib import Path @pytest.fixture(scope="session") def logged_in_browser_context(browser: Browser, tmp_path_factory) -> BrowserContext: """ 创建一个会话级、已登录的持久化上下文。 所有需要登录态的测试共享这个上下文，但与未登录的测试完全隔离。 """ # 为这个持久的登录上下文创建一个固定的存储目录 storage_dir = tmp_path_factory.mktemp("logged_in_context") storage_state_file = storage_dir / "state.json" context = browser.new_context( user_data_dir=str(storage_dir), viewport={'width': 1920, 'height': 1080}, ignore_https_errors=True, ) # 如果已有存储状态（之前登录过），直接加载 if storage_state_file.exists(): with open(storage_state_file, 'r') as f: storage_state = json.load(f) context = browser.new_context(storage_state=storage_state) else: # 首次运行，执行登录逻辑 page = context.new_page() page.goto('https://my-app.com/login') page.fill('#username', 'test_user') page.fill('#password', 'test_pass') page.click('#submit') page.wait_for_url('**/dashboard') # 等待登录成功 # 将登录状态（Cookies, LocalStorage等）保存到文件 storage_state = context.storage_state(path=str(storage_state_file)) page.close() yield context # 注意：会话结束时我们不关闭这个上下文，因为其他测试可能还要用。 # 但 browser fixture 最终会关闭所有关联的上下文。 @pytest.fixture def logged_in_page(logged_in_browser_context: BrowserContext) -> Page: """基于已登录上下文创建页面""" page = logged_in_browser_context.new_page() yield page page.close()

这样，你就可以拥有两套完全平行的测试环境：一套是纯净的、每次用例都重置的默认环境（page），另一套是共享登录态的持久化环境（logged_in_page）。它们之间的Cookie、Storage等是绝对隔离的。

4.2 文件系统访问控制与虚拟文件系统

测试文件上传下载时，我们同样需要隔离。Playwright 允许你为每个上下文设置一个“下载目录”，并可以模拟文件选择。

def test_file_upload_in_sandbox(page: Page, tmp_path): """在沙箱环境中测试文件上传""" # 1. 为当前测试创建一个临时输入文件 test_file = tmp_path / "test_upload.txt" test_file.write_text("This is sandboxed test data.") # 2. 设置文件选择器，让Playwright“选择”这个临时文件 # 注意：这不会触发系统文件选择对话框，完全在脚本控制下 await page.set_input_files('input[type="file"]', test_file) # 3. 触发上传 await page.click('#upload-button') await page.wait_for_selector('.upload-success') # 测试结束后，tmp_path及其下的文件会被Pytest自动清理 # 测试脚本从未接触过系统真实的下载目录或用户目录 def test_file_download_in_sandbox(page: Page, tmp_path): """在沙箱环境中测试文件下载""" # 监听下载事件，并指定下载到此上下文的私有目录 async with page.expect_download() as download_info: await page.click('#download-report-link') download = await download_info.value # 将文件保存到当前测试的临时目录，而非全局下载目录 save_path = tmp_path / download.suggested_filename await download.save_as(save_path) # 验证文件内容 assert save_path.exists() content = save_path.read_text() assert "Report Data" in content

通过结合tmp_path和 Playwright 的文件操作 API，我们将所有文件I/O都限制在了测试用例生命周期的临时目录内，实现了文件系统的隔离。

4.3 网络环境模拟与隔离

我们可以创建一个具有特定网络条件的独立上下文，用于测试弱网或离线场景。

from playwright.sync_api import Browser def create_throttled_context(browser: Browser, tmp_path): """创建一个模拟慢速3G网络的上下文""" context = browser.new_context( user_data_dir=str(tmp_path / "throttled_ctx"), # 通过CDP会话模拟网络条件（Playwright Python API 更简洁的方式在下面） ) # 更推荐的方式：使用 `context.set_offline` 或通过 route 模拟延迟 # 或者，在启动浏览器时通过args设置（影响所有上下文） # browser = p.chromium.launch(args=['--enable-network-throttling']) # 更精细的控制通常通过拦截和延迟响应来实现 async def slow_down(route): # 为所有请求添加2秒延迟 await asyncio.sleep(2) await route.continue_() await context.route('**/*', slow_down) return context

5. 完整项目代码结构与集成示例

让我们整合以上所有内容，形成一个完整的、可运行的项目结构。这个结构清晰，隔离策略明确，适合作为中型项目的测试框架基础。

playwright-sandbox-demo/ ├── conftest.py # Pytest全局配置，定义核心夹具 ├── requirements.txt # 项目依赖 ├── tests/ # 测试用例目录 │ ├── __init__.py │ ├── test_auth_flows.py # 认证相关测试（使用logged_in_page） │ ├── test_public_pages.py # 公开页面测试（使用普通page） │ └── test_file_operations.py # 文件操作测试 └── utils/ # 工具函数 └── test_helpers.py # 如登录函数、数据生成函数等

conftest.py(完整增强版)

import pytest import json from pathlib import Path from playwright.sync_api import Browser, BrowserContext, Page, sync_playwright from typing import Generator, Optional def pytest_addoption(parser): """添加自定义命令行选项""" parser.addoption( "--headed", action="store_true", default=False, help="以有头模式运行浏览器（非无头）", ) parser.addoption( "--slowmo", action="store", default=0, type=int, help="为每个Playwright操作添加延迟（毫秒），便于观察", ) @pytest.fixture(scope="session") def browser(pytestconfig) -> Generator[Browser, None, None]: """会话级浏览器实例，安全配置""" headed = pytestconfig.getoption("headed") slowmo = pytestconfig.getoption("slowmo") with sync_playwright() as p: browser = p.chromium.launch( headless=not headed, slow_mo=slowmo, args=[ '--disable-dev-shm-usage', '--disable-gpu', # 根据运行环境决定是否添加 --disable-setuid-sandbox # '--disable-setuid-sandbox' if running_in_docker else '', '--no-zygote', ] ) yield browser browser.close() @pytest.fixture(scope="function") def context(browser: Browser, tmp_path, pytestconfig) -> Generator[BrowserContext, None, None]: """函数级隔离上下文，每个测试用例一个""" user_data_dir = tmp_path / "pw_ctx" user_data_dir.mkdir(exist_ok=True) context = browser.new_context( user_data_dir=str(user_data_dir), ignore_https_errors=True, # 测试环境方便，生产慎用 viewport={'width': 1920, 'height': 1080}, # 可以录制测试视频，用于调试失败用例（会有性能开销） # record_video_dir='videos/' if pytestconfig.getoption("--record-video") else None, ) # 示例：为所有请求添加一个测试标记头 # async def add_header(route): # headers = route.request.headers # headers['X-Test-Id'] = 'sandbox-demo' # await route.continue_(headers=headers) # await context.route('**/*', add_header) yield context context.close() @pytest.fixture def page(context: BrowserContext) -> Generator[Page, None, None]: """函数级页面对象""" page = context.new_page() yield page page.close() # --- 高级夹具：持久化登录上下文 --- @pytest.fixture(scope="session") def logged_in_context(browser: Browser, tmp_path_factory, pytestconfig) -> Generator[BrowserContext, None, None]: """会话级已登录上下文（需实现具体登录逻辑）""" from utils.test_helpers import perform_login # 假设的登录辅助函数 storage_dir = tmp_path_factory.mktemp("logged_in_storage") storage_state_path = storage_dir / "state.json" context = browser.new_context( user_data_dir=str(storage_dir), viewport={'width': 1920, 'height': 1080}, ignore_https_errors=True, ) if storage_state_path.exists(): # 加载已有状态 with open(storage_state_path, 'r') as f: storage_state = json.load(f) # 需要先关闭刚创建的context，再用storage_state创建新的 context.close() context = browser.new_context(storage_state=storage_state) else: # 执行登录 page = context.new_page() # 这里调用你的登录函数 # perform_login(page) # 例如： page.goto("https://example.com/login") page.fill("#user", "test") page.fill("#pass", "test") page.click("#submit") page.wait_for_url("**/dashboard") # 保存状态 context.storage_state(path=str(storage_state_path)) page.close() yield context # 会话结束时不单独关闭，由browser fixture统一清理 @pytest.fixture def logged_in_page(logged_in_context: BrowserContext) -> Generator[Page, None, None]: """基于已登录上下文的页面""" page = logged_in_context.new_page() yield page page.close()

tests/test_public_pages.py(示例测试)

"""测试公开页面，使用完全隔离的上下文""" def test_homepage_loads_successfully(page: Page): page.goto("https://example.com") assert page.title() == "Example Domain" # 验证页面关键元素 assert page.is_visible('text="More information..."') def test_navigation_isolation(page: Page): """验证一个测试的导航不会影响另一个""" page.goto("https://httpbin.org/html") assert "Herman Melville" in page.content() # 在这个测试中，我们只在当前上下文的这个页面里 # 下一个测试会从一个全新的空白上下文开始

tests/test_auth_flows.py(示例测试)

"""测试需要登录态的功能，使用共享的已登录上下文""" def test_user_dashboard(logged_in_page: Page): """假设登录后跳转到仪表盘""" # 由于logged_in_page基于持久化上下文，我们可能已经在仪表盘页面，或者需要导航 logged_in_page.goto("https://example.com/dashboard") assert logged_in_page.is_visible('text="Welcome, test"') def test_user_profile(logged_in_page: Page): """测试个人资料页面""" logged_in_page.goto("https://example.com/profile") # 验证个人信息显示正确 # 注意：这个测试和上一个共享登录态，但浏览器上下文仍然是隔离的（与未登录测试）

6. 常见问题排查与实战心得

即便配置得当，在实际运行中你仍可能遇到各种问题。这里记录了一些典型问题和我的解决方案。

6.1 浏览器启动失败与沙箱冲突

问题: 在Docker或CI环境中，Playwright浏览器启动失败，报错包含Failed to move to new namespace、No usable sandbox!等。

根因: 系统内核配置或权限问题导致Chromium的沙箱无法正常初始化。

解决方案（按优先级尝试）:

1. 确保使用非root用户运行：在Dockerfile中明确指定USER nonroot。Chromium沙箱与root用户不兼容。
2. 添加正确的启动参数：在browser.launch的args列表中，按需添加：

   args=[ '--disable-dev-shm-usage', '--disable-gpu', '--disable-setuid-sandbox', # 针对Docker/非root环境 '--no-zygote', '--no-sandbox', # ！！！最后的手段，务必评估风险 ]

3. 在宿主机上配置正确的权限（对于Docker）：

   # 在Dockerfile中安装必要的依赖并设置权限 RUN apt-get update && apt-get install -y \ wget \ libgbm-dev \ libxss1 \ && rm -rf /var/lib/apt/lists/* # 确保你的非root用户有足够的权限（通常不需要特殊配置）

4. 使用Playwright的Docker镜像：微软官方提供了优化过的Docker镜像（如mcr.microsoft.com/playwright/python），其中已预配置了适合容器运行的环境，能极大减少此类问题。

6.2 测试并行化与资源竞争

问题: 使用pytest-xdist进行并行测试时，多个worker可能竞争同一临时目录或端口。

解决方案:

1. 利用tmp_path和tmp_path_factory：Pytest的这些夹具能自动为每个测试用例或worker生成唯一的临时路径，完美解决目录竞争。
2. 确保夹具作用域正确：browser用scope="session"，但context和page一定要用scope="function"。如果context误设为session，并行测试就会共享同一个上下文，导致状态污染。
3. 为每个worker配置独立的端口范围（如果需要启动后端服务）：可以通过环境变量为每个pytest worker分配不同的端口。

6.3 测试状态泄漏的调试

问题: 怀疑测试用例间有状态泄漏，但不确定来源。

调试步骤:

1. 启用Playwright Trace：在contextfixture中配置record_har或record_video，或者在测试失败时自动捕获Trace。

   context = browser.new_context( # ... 其他参数 ... record_har_path=f'har/{test_name}.har' if config.getoption("--record-har") else None, )

2. 手动检查存储：在测试teardown阶段，打印当前上下文的Cookies和LocalStorage。

   def teardown_function(): cookies = page.context.cookies() print(f"Test left cookies: {cookies}")

3. 使用“干净房间”测试：写一个最简单的测试，只打开一个空白页(about:blank)，然后检查是否有任何预设的Cookie或Storage。这能帮你判断污染是来自框架配置还是其他测试。

6.4 性能考量

沙箱化，尤其是为每个测试创建新的上下文和用户数据目录，会带来额外的开销（磁盘I/O、内存占用）。

优化建议:

1. 合理使用夹具作用域：不要过度使用function作用域。如果一组测试不修改浏览器状态，可以考虑共享一个context（scope="class"）。
2. 复用浏览器，但隔离上下文：正如我们的设计，复用browser（会话级）但创建新的context（函数级），是在隔离和性能间很好的平衡。
3. 清理策略：确保在测试结束后正确调用context.close()和page.close()，及时释放资源。Pytest的yield fixture模式很好地保证了这一点。
4. 监控资源：在CI中监控内存和CPU使用情况。如果发现内存持续增长，检查是否有未关闭的页面或上下文，或者考虑定期重启浏览器会话。

构建一个安全的Playwright沙箱测试环境，本质上是在“灵活性”和“可靠性”之间寻找最佳平衡点。经过多个项目的实践，我发现最有效的策略是默认严格隔离，按需谨慎共享。从每个测试用例一个全新上下文开始，只有当确凿的证据表明这是性能瓶颈时，才去考虑共享某些资源，并且要辅以严密的状态重置逻辑。这套以conftest.py为核心的配置，为我团队带来了测试稳定性的质的飞跃，希望它也能成为你自动化测试工具箱中可靠的一环。