如何验证Node.js项目代码中使用的所有环境变量均存在于对应.env文件中

第一步：收集项目所有用到的环境变量 #

• 用正则批量扫描项目下所有.js/.ts业务代码，匹配process.env.([A-Z_0-9]+)规则，提取所有用到的环境变量名，去重后生成必填变量清单，避免手动统计遗漏
• 如果是TypeScript项目，可以直接给process.env声明全局类型，所有用到的变量都在类型定义中列出，后续直接从类型文件提取清单即可，示例代码：

declare global {
  namespace NodeJS {
    interface ProcessEnv {
      A_VARIABLE: string;
      DB_HOST: string;
      DB_PORT: string;
      // 补充所有其他用到的环境变量
    }
  }
}

第二步：编写环境变量校验脚本 #

脚本支持适配dev/qa/prod多环境，校验不通过直接返回非0退出码，可直接作为流水线测试项运行，示例代码：

const dotenv = require('dotenv');
const fs = require('fs');

// 从命令行参数取当前部署环境
const deployEnv = process.argv[2] || 'dev';
// 加载对应环境的.env配置文件
const envFileContent = fs.readFileSync(`.env.${deployEnv}`);
const envConfig = dotenv.parse(envFileContent);
Object.assign(process.env, envConfig);

// 必填变量清单，可直接读取第一步生成的静态扫描结果
const REQUIRED_ENV_LIST = [
  'A_VARIABLE',
  'DB_HOST',
  'DB_PORT',
  // 补充所有必填变量
];

// 校验缺失的变量
const missingVars = REQUIRED_ENV_LIST.filter(varName => !process.env[varName]?.trim());

if (missingVars.length > 0) {
  console.error(`❌ ${deployEnv}环境缺失以下必填环境变量：\n${missingVars.join('\n')}`);
  // 非0退出码会触发流水线失败告警
  process.exit(1);
}

console.log(`✅ ${deployEnv}环境所有必填环境变量配置完整`);
process.exit(0);

第三步：配置到流水线 #

在流水线的测试阶段、部署流程前添加执行命令：node 你的脚本路径/check-env.js ${当前部署环境变量}，只要存在缺失变量，流水线会自动终止部署并抛出告警。

可选兜底方案：运行时启动校验 #

在项目入口文件最顶部引入校验逻辑，本地开发、手动部署时也能第一时间发现环境变量配置问题，避免运行时才报功能错误。

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