如何用TypeScript确保process.env.queueUrl始终为字符串类型？

问题场景 #

通过Lambda Stack的environment键传递环境变量给Lambda函数时遇到类型错误：

传递变量代码： #

environment: {
  queueArn: sqsStack.sqsQueue.queueArn,
  queueUrl: sqsStack.sqsQueue.queueUrl,
},

错误信息： #

Argument of type '{ MessageBody: string; QueueUrl: string | undefined; }' is not assignable to parameter of type 'SendMessageRequest'.

Lambda代码： #

var params = {
  MessageBody: "STRING_VALUE" /* required */,
  QueueUrl: process.env.queueUrl /* required */,
};

sqs.sendMessage(params, function (err, data) {
  if (err) console.log(err, err.stack); // 发生错误
  else console.log(data); // 响应成功
});

解决方案 #

TypeScript默认认为process.env的属性可能为undefined，因为环境变量存在未注入的可能性。以下几种方式可以确保queueUrl被识别为字符串类型：

• 非空断言
  直接告知TypeScript该变量一定存在，使用!操作符：

var params = {
  MessageBody: "STRING_VALUE",
  QueueUrl: process.env.queueUrl!,
};

注意：需确保部署时环境变量已正确配置，否则运行时会触发错误。

• 运行时检查+报错
  添加类型守卫逻辑，在变量不存在时主动抛出错误，同时让TypeScript自动推断变量类型：

const queueUrl = process.env.queueUrl;
if (!queueUrl) {
  throw new Error("环境变量queueUrl未设置");
}

var params = {
  MessageBody: "STRING_VALUE",
  QueueUrl: queueUrl,
};

这种方式更安全，能提前捕获配置缺失问题。

• 声明process.env类型
  在项目中创建类型声明文件（如env.d.ts），明确指定环境变量的类型：

declare global {
  namespace NodeJS {
    interface ProcessEnv {
      queueUrl: string;
      queueArn: string;
    }
  }
}

export {};

配置后TypeScript会直接认定process.env.queueUrl为字符串类型，但仍需保证实际部署时变量已正确注入。

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