如何在AWS Lambda的NodeJsFunction中扩展现有环境变量NODE_PATH

要在CDK的NodeJsFunction构造中扩展默认的NODE_PATH（而非硬编码默认值），你需要确保环境变量的引用能被Lambda运行时正确解析，而非被本地JS/TS代码提前插值。以下是可行方案：

方法1：用单引号传递字面量字符串 #

设置环境变量时用单引号包裹值，避免本地模板字符串解析：

import { NodejsFunction } from 'aws-cdk-lib/aws-lambda-nodejs';

// ...

const lambdaFn = new NodejsFunction(this, 'MyLambda', {
  // 其他配置项
  environment: {
    NODE_PATH: '${NODE_PATH}:/opt/special'
  }
});

${NODE_PATH}会原封不动传递给Lambda，运行时自动替换为默认NODE_PATH值，最终得到类似/opt/nodejs/node_modules:/opt/special的结果。

方法2：使用CloudFormation的Fn.sub构造值 #

通过CDK的Fn.sub函数明确构造环境变量值，确保变量引用被正确处理：

import { NodejsFunction } from 'aws-cdk-lib/aws-lambda-nodejs';
import { Fn } from 'aws-cdk-lib';

// ...

const lambdaFn = new NodejsFunction(this, 'MyLambda', {
  // 其他配置项
  environment: {
    NODE_PATH: Fn.sub('${NODE_PATH}:/opt/special')
  }
});

之前尝试无效的原因 #

如果用双引号写"${NODE_PATH}:/opt/special"，本地JS/TS会把它当作模板字符串，尝试读取当前进程的NODE_PATH（而非Lambda运行时的默认值），导致传递给Lambda的是错误值。必须用单引号或Fn.sub确保引用字符串原封不动传递到运行时。

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