随着前端自动化测试的日益普及，Playwright 凭借其跨浏览器、高性能和强大的 API 迅速成为开发者首选。然而，在复杂测试场景中，Fixture（夹具）的执行顺序往往成为影响测试稳定性和效率的关键因素。近期，Playwright 社区围绕“Fixture Run In Order”的讨论热度攀升，本文将系统梳理其运行规则、常见陷阱与最佳实践。

一、Fixture 顺序的核心原则

在 Playwright 测试框架（尤其是基于 pytest-playwright 的项目）中，Fixture 的执行遵循明确的优先级与依赖规则。其核心可概括为：作用域越大越先执行，依赖者后于被依赖者。

具体而言，pytest 原生支持四种作用域：session、module、class 和 function（默认）。Playwright 在此基础上扩展了 test、worker 等作用域。在一次测试会话中，所有 session 作用域的 Fixture 最先执行，随后依次为 module、class，最后是 function 作用域内的 Fixture。同一作用域内的多个 Fixture 则按照其在测试函数参数列表中的从左到右顺序执行。

例如：

@pytest.fixture(scope="session")
def browser_context():
    # 整个会话只执行一次
    ...

@pytest.fixture(scope="function")
def page(browser_context):
    # 每个测试函数执行一次，依赖于 browser_context
    ...

在此例中，browser_context 必然在 page 之前运行，且仅运行一次。

二、依赖链与自动执行（Autouse）的影响

Fixture 之间的依赖关系通过函数参数显式声明。Playwright 的 Fixture 系统会自动解析依赖图，确保被依赖的 Fixture 优先执行。这一机制天然保证了顺序的正确性，但开发者若嵌套多层依赖，仍需警惕性能损耗。

另一个容易忽略的因素是 autouse Fixture。当 Fixture 被标记为 autouse=True 时，它会自动作用于同级作用域下的所有测试函数，无需显式调用。其执行顺序遵循“先定义先执行”的规则，并与显式 Fixture 交织在一起。例如，若同时存在一个 autouse 的 page Fixture 和一个显式的 context Fixture，则先定义的那个会先运行。

Playwright 官方建议：尽量少用 autouse，仅在必须初始化或清理测试环境（如设置 Cookies、拦截网络请求）时开启，以避免意外干扰测试流。

三、常见顺序陷阱与解决策略

在实际项目中，Fixture 顺序问题常常导致测试失败或资源泄漏。以下三种场景尤为典型：

  1. 共享状态被提前销毁
    假设一个 module 作用域的 Fixture 创建了浏览器实例，而另一个 function 作用域的 Fixture 依赖它并修改了状态。若销毁顺序不当，后执行的清理操作可能访问已释放的资源。解决方案是使用 yield 代替 return，确保在 Fixture 退出时执行清理，且依赖链会按逆序释放。

  2. 不同文件之间的作用域冲突
    当多个测试模块共用同一个 conftest.py 中的 Fixture 时，同一作用域内的执行顺序取决于模块导入顺序。为避免不确定性，应显式声明依赖关系，或通过 @pytest.mark.tryfirst 等标记调整优先级。

  3. 异步 Fixture 中的顺序控制
    Playwright 原生支持异步 Fixture（如 async def），其执行遵循事件循环调度，但依赖关系依然遵循同步规则。开发者需注意：即使 Fixture 是异步的，其调用顺序仍受 pytest 控制，不会乱序。

四、最佳实践：如何显式控制顺序

对于需要精细控制顺序的场景，Playwright 推荐以下方法：

  • 使用 Fixture 的 order 参数（pytest-playwright 扩展）：某些插件支持为 Fixture 设置整数优先级，数值越小越先执行。
  • 利用 @pytest.fixture(autouse=True) 配合 scope 控制全局初始化：例如，所有测试开始前先执行登录 Fixture。
  • 避免循环依赖：若 Fixture A 依赖 B，B 又依赖 A，pytest 会抛出 FixturesCycleError，需重构代码。
  • 使用 pytest_collection_modifyitems 钩子：高级用户可通过钩子函数，在收集阶段动态调整 Fixture 的优先级顺序。

五、结语

“Playwright Fixture Run In Order”不仅是技术细节，更是构建稳健测试框架的基石。理解并合理运用作用域、依赖链和 autouse 机制，能够显著提升测试的可维护性和执行效率。随着 Playwright 生态的持续演进，未来或许会引入更直观的排序 API 或可视化调试工具，但当前阶段，掌握这些核心规则依然是每位测试工程师的必修课。

开发者们不妨在项目中审视自己的 Fixture 定义，尝试用最简洁的依赖图，换取最可靠的测试结果。