Cypress无头模式下跨Spec环境变量丢失，testIsolation配置失效问题

问题描述 #

我有一系列存在依赖关系的Cypress测试Spec（受被测项目规范限制，无法改为独立测试）：

• 在第一个Spec（spec1.cy.ts）中，我创建对象数组并设置为环境变量，供其他Spec调用：

const arrafOfObjects = pageObject.functionThatReturnsTheArray();

Cypress.env("arrafOfObjects", arrafOfObjects);

• 带UI的有界面模式下运行正常，但无头模式下，第二个Spec（spec2.cy.ts）获取该环境变量时返回undefined，触发报错：

const arrafOfObjects = Cypress.env("arrafOfObjects");

const length = arrafOfObjects.length //TypeError: Cannot read properties of undefined (reading 'length')

我已经在cypress.config.js中配置了testIsolation: false，但排查发现无头模式似乎忽略该配置，内存被清空，请问原因是什么？

附cypress.config.js配置：

const { defineConfig } = require("cypress");
const { verifyDownloadTasks } = require('cy-verify-downloads');
const { removeDirectory } = require('cypress-delete-downloads-folder');

const env = 'staging' 

module.exports = defineConfig({

  env:{
    godUser: 'some.user@domain.cloud',
    passwordChargeGodUser: 'secretPassword',
    securityconfigHash: process.env.secretConfigHash
  },

  e2e: {
    baseUrl: 'https://url.' + env + '.domain.cloud',
    excludeSpecPattern : ["cypress/e2e/2-advanced-examples","cypress/e2e/1-getting-started", "cypress/e2e/0-financeportal"],
    downloadsFolder: "cypress/downloads",
    testIsolation: false,
    trashAssetsBeforeRuns : true,
    experimentalRunAllSpecs : true,
    chromeWebSecurity: false,
    experimentalModifyObstructiveThirdPartyCode: true,
    experimentalOriginDependencies: false,
    
    defaultCommandTimeout: 10000,
    numTestsKeptInMemory : 0,
    requestTimeout : 30000,
    responseTimeout : 50000,
    pageLoadTimeout: 1000000, 
    setupNodeEvents(on, config) {
      on('task', verifyDownloadTasks);
      on('task', { removeDirectory })
    },
  },

});

问题原因与解决方案 #

核心原因 #

你配置的numTestsKeptInMemory: 0是关键问题——这个配置会强制Cypress在每个测试完成后清空内存中的所有测试上下文，包括通过Cypress.env()设置的临时变量。

testIsolation: false仅控制页面上下文的隔离（比如不清除localStorage、不重置页面），但不影响Cypress内部的测试内存上下文清理。UI模式下Cypress对该内存配置有特殊兼容处理，而无头模式会严格执行配置规则，导致跨Spec的变量共享失效。

修复步骤 #

1. 调整内存保留配置：将numTestsKeptInMemory改为大于0的数值（比如numTestsKeptInMemory: 10），或者直接删除该配置（Cypress默认会保留所有测试上下文），这样跨Spec的环境变量就能正常传递。
2. 验证修复效果：修改配置后重新运行无头模式测试，确认spec2.cy.ts能正常获取到arrafOfObjects变量。
3. 备选方案（无法修改内存配置时）：如果受限于项目规范不能调整内存配置，可以通过文件读写实现跨Spec数据共享：
   • 在spec1.cy.ts中写入临时文件：

     const arrafOfObjects = pageObject.functionThatReturnsTheArray();
     cy.writeFile('cypress/fixtures/tempData.json', arrafOfObjects);
     

   • 在spec2.cy.ts中读取文件：

     cy.readFile('cypress/fixtures/tempData.json').then(arrafOfObjects => {
       const length = arrafOfObjects.length;
       // 后续测试逻辑
     });
     

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