TypeScript中dotenv类型化环境变量搭配nodemon触发TS2322错误求解

问题根源 #

• 环境变量在Node.js中本质上都是字符串类型，dotenv仅负责读取.env文件内容为字符串，不会自动做类型转换。
• 你在env.d.ts里声明MY_VARIABLE为number，只是给TypeScript提供了静态类型提示，但这和运行时实际的变量类型不匹配。
• 用tsc编译后运行时，TypeScript的类型信息会被移除，Node.js不做类型校验所以不会报错；但ts-node或nodemon运行时会实时校验类型，发现process.env.MY_VARIABLE的实际类型是string | undefined，和声明的number类型冲突，因此抛出错误。

解决方法 #

方法1：显式转换并验证类型（推荐） #

使用环境变量时手动转换为数字，同时添加合法性校验，避免无效值引发运行时问题：

// 处理环境变量
const rawMyVar = process.env.MY_VARIABLE;
const myVar = rawMyVar ? Number(rawMyVar) : undefined;

// 验证转换结果
if (myVar !== undefined && isNaN(myVar)) {
  throw new Error("环境变量MY_VARIABLE必须是有效的数字");
}

// 使用转换后的值
const x = new MyClass(myVar);

方法2：修正类型声明并封装工具函数 #

先修正类型声明使其符合环境变量的本质类型，再封装工具函数统一处理类型转换：

// env.d.ts
declare global {
    namespace NodeJS {
        interface ProcessEnv {
            MY_VARIABLE: string;
        }
    }
}

export {};

// 工具函数：获取并转换数字类型的环境变量
function getEnvNumber(key: keyof NodeJS.ProcessEnv): number | undefined {
  const value = process.env[key];
  if (!value) return undefined;
  
  const num = Number(value);
  if (isNaN(num)) {
    throw new Error(`环境变量${key}必须是有效的数字`);
  }
  
  return num;
}

// 使用
const x = new MyClass(getEnvNumber("MY_VARIABLE"));

方法3：类型断言（不推荐） #

如果你能100%确保MY_VARIABLE的取值是合法的数字字符串，可以用类型断言跳过类型检查，但这种方式不安全，一旦环境变量值非法会导致运行时问题：

const x = new MyClass(process.env.MY_VARIABLE as unknown as number);

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