Skip to content

测试依赖环境:在 CI 失败但本地通过

快速摘要

你的测试在本地通过但在 CI 中失败 —— 它依赖环境特定的设置或资源。

为什么发生

  • 测试使用本地有效但在 CI 环境中无效的硬编码文件路径

  • 本地存在的环境变量或配置在 CI 中缺失

  • 测试依赖 OS 特定行为、行结尾或文件系统大小写敏感性

最小示例

✗ 错误代码
test('reads config', () => {
  const config = fs.readFileSync('/home/user/config.json'); // works locally, fails in CI
  expect(config.port).toBe(3000);
});
✓ 修复代码
test('reads config', () => {
  const configPath = path.join(process.env.CONFIG_DIR || '/default/config', 'config.json');
  const config = fs.readFileSync(configPath);
  expect(config.port).toBe(3000);
});

使用环境变量作为配置目录使测试在本地和 CI 环境中都能工作。

如何诊断

  • 比较本地和 CI 环境在路径、环境变量和 OS 方面的差异

  • 以与 CI 相同的配置在本地运行测试(如 Docker 容器中)

  • 检查硬编码路径、环境特定值或 OS 依赖行为

如何修复

  • 使用环境变量或配置文件处理环境特定值

  • 使用 path.join 和 path.resolve 处理文件路径而非硬编码分隔符

  • Mock 或参数化 OS 特定行为使测试环境无关

如何预防

  • 永不硬编码路径或环境特定值 —— 使用配置和环境变量

  • 在与 CI 相同的环境中运行测试(如 Docker)以尽早捕获环境问题

相关资源

相关术语

相关课程

← 返回语言