jest与puppeteer测试批量运行失败、单独运行通过该怎么解决

根本原因 #

你遇到的单测单独执行通过、批量执行失败的问题，本质都是测试套件间的上下文互相干扰，常见的具体诱因包括：

• 状态污染：如果多个测试套件共享同一个 Puppeteer Browser 或 Page 实例，前一个套件执行时写入的 Cookie、localStorage/sessionStorage、页面路由跳转、表单状态、全局JS变量修改没有被清理，会直接影响后一个执行的测试套件的上下文，导致执行结果不符合预期。
• 资源抢占冲突：Jest 默认会并行执行多个测试文件，并行场景下多个套件同时操作同一个浏览器实例、同一个端口的调试服务、甚至同一个页面元素，会出现资源竞争问题，比如前一个测试还没完成页面跳转、后一个测试就尝试获取DOM元素，直接触发元素不存在的报错。
• 执行顺序依赖：如果你的测试套件隐含了前置执行要求（比如A套件先写入测试数据，B套件再读取校验），Jest 并行执行时会打乱默认的文件执行顺序，就会出现依赖缺失导致的执行失败。

修复建议 #

你需要在测试生命周期中增加资源重置逻辑，具体可以按以下优先级选择方案：

1. 优先做完全上下文隔离：每个测试套件单独启动独立的 Browser 实例，在套件的 afterAll 钩子中执行 await browser.close() 主动关闭实例，彻底切断套件间的状态关联，这种方案可靠性最高，只会小幅增加测试执行耗时。
2. 如果要复用 Browser 实例提升执行速度，就要为每个测试套件单独创建 Page 实例，在 beforeEach 阶段执行以下清理操作：
   • 执行 await page.goto('about:blank') 跳转到空白页清空当前页面状态
   • 执行以下代码清理所有本地存储和Cookie：

     await page.evaluate(() => {
       localStorage.clear();
       sessionStorage.clear();
       document.cookie.split(";").forEach(c => {
         document.cookie = c.replace(/^ +/, "").replace(/=.*/, "=;expires=" + new Date().toUTCString() + ";path=/");
       })
     })
     

   • 重置所有自定义的全局变量到初始值
3. 临时验证可以修改 Jest 配置，新增 maxWorkers: 1 配置强制串行执行所有测试套件，如果串行执行没有报错，就可以100%确认是并行执行导致的上下文冲突问题。
4. 另外需要保证每个测试套件的逻辑都是独立的，不要隐含对其他测试套件执行结果的依赖。

内容的提问来源于stack exchange，提问作者roy