Cypress无法读取cypress.env.json环境变量，求解决方案

可能原因及解决方案 #

1. 检查cypress.env.json文件位置 #

Cypress默认从项目根目录读取cypress.env.json，你的文件放在tests/子目录下，框架无法自动识别。

• 方案一：直接将cypress.env.json移动到项目根目录。
• 方案二：如果不想移动文件，修改cypress.config.js（或cypress.config.ts），手动加载指定路径的环境变量文件：

const { defineConfig } = require('cypress')
const fs = require('fs')
const path = require('path')

module.exports = defineConfig({
  e2e: {
    setupNodeEvents(on, config) {
      const envFilePath = path.resolve(__dirname, 'tests/cypress.env.json')
      const envData = JSON.parse(fs.readFileSync(envFilePath, 'utf8'))
      // 合并原有环境变量与自定义文件中的变量
      config.env = { ...config.env, ...envData }
      return config
    },
  },
})

2. 验证环境变量是否成功加载 #

在测试代码中添加调试代码，确认变量是否被正确读取：

it('调试环境变量', () => {
  console.log('所有环境变量:', Cypress.env())
  console.log('loginTestStage变量:', Cypress.env('loginTestStage'))
})

运行测试后查看控制台输出，确认loginTestStage是否存在且结构正确。

3. 适配Cypress版本 #

如果使用Cypress 10+，确保配置文件是cypress.config.js（而非旧版的cypress.json）。若使用Cypress 9及以下，可在cypress.json中添加env配置，或确保cypress.env.json在根目录。

4. 容错处理避免报错 #

暂时添加兜底逻辑，防止因变量未加载导致测试直接崩溃，同时辅助排查问题：

it('Allow users with valid credentials to login', () => {
  const loginTestStage = Cypress.env('loginTestStage') || {}
  const adminCredentials = loginTestStage.admin || { username: '', password: '' }
  const { username, password } = adminCredentials

  cy.get(usernameInput).type(username)
  cy.get(passwordInput).type(password)
  // ... 后续测试逻辑
})

5. 校验JSON文件格式 #

确认cypress.env.json的JSON格式完全正确，无多余逗号、引号不匹配等语法错误（可通过在线JSON校验工具验证）。

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