Jest测试环境无法读取.env变量的问题与解决方案咨询

这是正常现象吗？ #

是正常的。Jest启动时会重置process.env为一个干净的对象，默认不会自动加载项目根目录的.env文件，所以测试代码里访问自定义环境变量会得到undefined。

存储这类变量的最佳实践 #

• 分环境隔离配置：创建.env.test文件专门存放测试环境的变量，避免测试和生产环境的配置互相干扰，比如测试用的数据库地址、API密钥可以和生产环境不同。
• 用dotenv加载变量：借助dotenv包（如果项目已使用）在测试初始化阶段加载对应环境的配置文件。
• 通过Jest配置初始化脚本：用setupFiles或setupFilesAfterEnv指定初始化文件，确保在测试执行前完成环境变量的注入。
• 敏感变量用模拟值：测试时无需使用真实的敏感密钥（比如支付接口密钥），直接在测试脚本里模拟对应的变量值即可，避免泄露风险。

你提到的配置是否足够？ #

不够。你只在jest.config.ts里配置了setupFiles指向.jest/setEnvVars.ts，但这个文件里还需要添加加载环境变量的代码才行，示例如下：

// .jest/setEnvVars.ts
import dotenv from 'dotenv';

// 加载根目录的.env文件，也可指定加载测试环境专属的.env.test
dotenv.config({ path: '<rootDir>/.env' });
// dotenv.config({ path: '<rootDir>/.env.test' });

如果项目没装dotenv，需要先安装：

npm install dotenv --save-dev

另外，也可以直接在jest.config.ts里通过globals配置注入少量简单变量，但这种方式灵活性不如用dotenv，只适合非敏感的基础配置。

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