测试依赖环境:在 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)以尽早捕获环境问题