Cypress 10+如何从CLI/Node.js指定测试JSON数据文件及解决加载报错

你的方案本身存在逻辑问题，并非语法错误。核心原因是Node.js的require()是静态加载机制：它会在代码编译阶段就解析模块路径，而Cypress.env('TEST_DATA_JSON_PATH')是Cypress运行时才注入的动态值——编译阶段这个变量还未被赋值，require()自然找不到对应的模块文件。

下面是两种可行的解决方法：

方法1：使用Cypress内置的cy.fixture()加载（推荐） #

cy.fixture()是Cypress专为加载测试数据设计的API，支持运行时动态路径，完美适配你的场景。修改utils.js如下：

// utils.js
export const getTestData = () => {
  const dataPath = Cypress.env('TEST_DATA_JSON_PATH')
  return cy.fixture(dataPath.replace('cypress/fixtures/', '')) 
  // cy.fixture默认从fixtures目录开始查找，因此需要去掉路径前缀
}

在测试用例中调用：

// 测试文件
import { getTestData } from '../utils'

describe('测试套件', () => {
  let testData
  before(() => {
    getTestData().then(data => {
      testData = data
    })
  })

  it('测试用例', () => {
    // 使用testData中的数据
    cy.get('#username').type(testData.username)
  })
})

执行命令保持不变：

npx cypress run --config baseUrl=https://test.client01.global/ --env TEST_DATA_JSON_PATH=cypress/fixtures/testData_alt_01.json

方法2：使用Node.js动态导入import() #

如果需要在非测试上下文（比如自定义命令、全局钩子的同步逻辑）中使用数据，可以用异步动态导入，因为import()是运行时执行的：

// utils.js
export let testData

export const loadTestData = async () => {
  const dataPath = Cypress.env('TEST_DATA_JSON_PATH')
  testData = await import(`../${dataPath.replace('cypress/', '')}`)
  // 路径需根据utils.js的实际位置调整，此处假设utils在cypress/support目录下
}

在cypress/support/e2e.js中提前加载数据：

import { loadTestData } from './utils'

before(async () => {
  await loadTestData()
})

测试用例中直接使用：

import { testData } from '../utils'

it('测试用例', () => {
  cy.get('#username').type(testData.default.username)
  // 动态导入的模块会被包裹在default属性中，需注意取值方式
})

执行命令同样保持不变。

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