Protractor套件执行异常：仅首个Spec运行其余超时失败

我之前也遇到过一模一样的情况——单个Spec跑起来都正常，一整组套件执行就卡壳在第一个用例后面，剩下的全部超时。结合你的配置来看，大概率是测试环境没有在Spec之间正确重置或者浏览器上下文残留状态导致的，给你几个排查方向：

先贴出你的配置方便参考：

suites:{ 
  forms:['specs/requestE.js'], 
  search:['specs/findaSpec.js'], 
  offers:['specs/offersPrograms.js','specs/destinationsSpec.js'], 
  headerfooterlinks:['specs/footerlinksSpec.js','specs/headerMenuSpec.js'] 
},

1. 强制在每个Spec后清理浏览器状态 #

这是最常见的原因：第一个Spec执行后，浏览器里残留了Cookie、LocalStorage、未关闭的页面弹窗或者未完成的网络请求，导致后续Spec无法正常初始化。

你需要在全局的测试钩子（比如afterEach）里添加清理逻辑，以Cypress为例，在cypress/support/e2e.js里添加：

afterEach(() => {
  // 清除所有Cookie和本地存储
  cy.clearCookies();
  cy.clearLocalStorage();
  cy.window().then(win => win.sessionStorage.clear());
  // 重置到空白页面，避免残留页面元素干扰
  cy.visit('about:blank');
});

如果是Protractor、Playwright这类框架，也有对应的清理API，核心思路就是让每个Spec都在“干净”的浏览器环境里启动。

2. 确认套件是串行执行（而非并行） #

有些测试框架默认会尝试并行执行套件里的Spec，但如果你的测试依赖同一个浏览器实例，并行会导致上下文冲突，后续Spec根本无法获取到正确的执行环境。

检查你的框架配置，确保套件是串行执行的：

• Cypress：在cypress.config.js里设置experimentalSessionAndOrigin: true，或者明确parallel: false
• Protractor：在conf.js里设置shardTestFiles: false

3. 检查首个Spec是否有未完成的异步操作 #

如果第一个Spec里有未等待完成的网络请求、定时器，或者没有关闭的模态框，会阻塞整个测试进程，导致后续Spec永远无法开始执行。

在首个Spec的after钩子里添加等待逻辑，确保所有异步操作都完成：

after(() => {
  // 等待所有网络请求结束（以Cypress自定义命令为例）
  cy.waitForAllRequests();
  // 如果有模态框，确保关闭
  cy.get('.modal-close').click({ force: true });
});

4. 调大套件级别的超时时间 #

有时候不是执行不了，而是整个套件的超时设置太短，比如你单个Spec需要3分钟，套件总超时只设了4分钟，第二个Spec还没开始就触发超时了。

找到你测试框架的超时配置项，比如：

• Cypress：defaultCommandTimeout（单个命令超时）和pageLoadTimeout（页面加载超时）
• Protractor：allScriptsTimeout和jasmineNodeOpts.defaultTimeoutInterval

适当调大这些数值，给后续Spec足够的执行时间。

5. 验证Spec文件路径和依赖 #

虽然你说单个跑没问题，但套件模式下部分框架的路径解析逻辑可能不同，再确认一遍套件里的文件路径没有拼写错误，比如specs/findaSpec.js是不是应该是specs/findASpec.js？另外检查多个Spec之间有没有共享的全局变量冲突，导致后续Spec执行失败。

先从第1点的清理逻辑入手，这解决了我当时的问题，要是还不行再逐一排查后面的方向。

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