后端使用dotenv加载环境变量时触发TypeScript类型报错

这个报错是TypeScript静态类型检查的正常提示：process.env下挂载的所有环境变量，TS默认给的类型都是string | undefined——毕竟TS没法在编译阶段扫到你本地的.env文件，没法百分百保证DB_CONNECTION字段一定存在，自然会认为你传的值可能是undefined，不符合mongoose.connect要求的string类型入参。

根据项目场景可以选下面几种解决方式：

不要直接跳过类型检查，先在服务启动阶段校验所有必填的环境变量，缺了就直接抛错终止启动，避免服务跑一半才出莫名其妙的连接问题。经过if判断的分支里，TS会自动把值的类型收窄为string，不会再报类型错误：

import 'dotenv/config';
import mongoose from 'mongoose';

// 校验必填环境变量
const dbConnectionStr = process.env.DB_CONNECTION;
if (!dbConnectionStr) {
  throw new Error('启动失败：请在.env文件中配置DB_CONNECTION数据库连接串');
}

// 这里dbConnectionStr的类型已经被TS推导为string，可以直接传入
mongoose.connect(
  dbConnectionStr,
  {
    useUnifiedTopology: true,
    useNewUrlParser: true,
    useCreateIndex: true,
  },
  () => {
    console.log('connected to db');
  }
);

如果你确定自己的.env里肯定配了这个字段，不想写额外校验逻辑，可以用TS的非空断言操作符!，手动告诉TS这个值不可能为空，直接跳过检查：

mongoose.connect(
  process.env.DB_CONNECTION!, // 变量后加!就是非空断言
  {
    useUnifiedTopology: true,
    useNewUrlParser: true,
    useCreateIndex: true,
  },
  () => {
    console.log('connected to db');
  }
);

注意：这种写法有运行时隐患，如果哪天你改.env不小心删了这个字段，TS不会给任何提示，运行时会直接把undefined传给mongoose，抛出的连接错误排查起来反而麻烦。

如果项目里用的环境变量很多，可以在src目录下新建environment.d.ts类型声明文件，统一给所有用到的环境变量声明类型：

export {};

declare global {
  namespace NodeJS {
    interface ProcessEnv {
      DB_CONNECTION: string;
      // 其余环境变量也可以在这里统一声明，比如PORT: string; JWT_SECRET: string;
    }
  }
}

加完这个声明后，TS会默认process.env.DB_CONNECTION是string类型，不会再报类型错误。
注意：这个方案只是补全了静态类型，本质还是没解决运行时变量缺失的问题，生产环境用最好还是配合方案1的启动校验逻辑。

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