Node.js Jest测试环境变量加载异常及日志失效问题求助

核心问题分析 #

测试时环境变量加载失败，核心原因通常是dotenv加载时机晚于测试代码执行，或者Jest运行时的工作目录与预期不符，导致无法正确读取根目录的.env文件。

具体解决方法 #

1. 让Jest在测试启动前强制加载dotenv #

最直接的方式是通过Jest配置的setupFiles选项，在所有测试代码执行前加载dotenv：

修改你的jest.config.js，添加setupFiles配置：

module.exports = {
  preset: "ts-jest",
  testEnvironment: "node",
  testMatch: ["**/*.test.ts"],
  globals: {
    "ts-jest": {
      tsconfig: "tsconfig.test.json",
    },
  },
  // 添加这一行，让dotenv在测试前自动加载根目录的.env
  setupFiles: ['dotenv/config']
};

dotenv/config是dotenv提供的内置入口，会自动从项目根目录加载.env文件，无需手动指定路径。

2. 手动指定.env路径（避免process.cwd()的坑） #

如果不想用内置入口，可以创建一个单独的Jest初始化文件，明确指定.env的绝对路径：

创建jest.setup.ts文件：

import dotenv from 'dotenv';
import path from 'path';

// 基于当前文件位置定位根目录的.env，不受工作目录影响
dotenv.config({ 
  path: path.resolve(__dirname, '.env'), 
  debug: true 
});

然后修改jest.config.js的setupFiles指向这个文件：

module.exports = {
  // ... 原有配置
  setupFiles: ['./jest.setup.ts']
};

3. 确保dotenv在服务器代码中优先加载 #

检查你的Express服务器代码，确保dotenv加载在所有依赖环境变量的代码之前：

// 服务器入口文件（比如src/app.ts）
import dotenv from 'dotenv';
import path from 'path';

// 先加载环境变量
dotenv.config({ path: path.resolve(__dirname, '../.env'), debug: true });

// 再导入其他依赖（包括调用getEnv的模块）
import { getEnv } from './utils/env';
import express from 'express';

export const getApp = () => {
  const app = express();
  // ... 路由配置等
  return app;
};

如果dotenv是在getApp函数内部才加载，测试时调用getApp前可能已经有代码提前调用了getEnv，导致报错。

4. 验证dotenv加载状态 #

开启dotenv的debug模式后，运行测试时可以在控制台看到加载日志，确认是否成功读取了.env文件：

[dotenv] Parsed 5 variables from /path/to/your/project/.env

如果没有看到这条日志，说明dotenv根本没加载，检查setup配置是否生效。

额外排查点 #

• 确认你的.env文件没有拼写错误，且所有被getEnv调用的变量都已定义
• 不要在测试代码中覆盖process.env，避免干扰环境变量读取
• 如果有单独的test.env文件，需要在setup时指定path: path.resolve(__dirname, '.env.test')

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