如何在AWS CDK构建的Node.js Lambda中启用装饰器并修复依赖注入问题

问题根源 #

esBuild默认配置会触发两个导致tsyringe失效的核心行为：

• 树摇（Tree Shaking）会移除tsyringe依赖的装饰器元数据代码——这类代码没有被直接调用，会被判定为"无用代码"清除
• 默认不保留TypeScript装饰器的元数据，导致@injectable()、@inject()等标记无法被tsyringe识别

具体修复步骤 #

1. 调整AWS CDK的esBuild构建配置 #

在Lambda函数的CDK定义中，修改bundling参数，禁用树摇并指定专用TypeScript配置：

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

const lambdaFn = new NodejsFunction(this, 'MyInjectedLambda', {
  // 其他原有配置（如运行时、内存等）
  bundling: {
    minify: false, // 先禁用压缩，避免额外的代码移除逻辑干扰
    treeShaking: false, // 关键：彻底禁用树摇，保留tsyringe依赖的元数据代码
    tsconfig: 'tsconfig.lambda.json', // 单独指定Lambda的TS配置，不影响项目其他部分
  },
});

2. 配置TypeScript保留装饰器元数据 #

创建tsconfig.lambda.json文件，继承项目主配置并添加元数据保留选项：

{
  "extends": "./tsconfig.json",
  "compilerOptions": {
    "experimentalDecorators": true,
    "emitDecoratorMetadata": true, // 强制保留装饰器元数据，tsyringe核心依赖
    "target": "ES2020", // 匹配Lambda当前默认的Node.js 18.x/20.x运行时
    "module": "ESNext"
  }
}

3. 显式锚定tsyringe依赖，避免被误删 #

在Lambda入口文件顶部，显式导入反射元数据库并注册依赖，确保相关代码不会被树摇移除：

import 'reflect-metadata'; // tsyringe必须依赖的元数据处理库，必须显式导入
import { container } from 'tsyringe';
import { MyService } from './services/my-service';

// 显式注册单例依赖，避免被判定为无用代码
container.registerSingleton(MyService);

export const handler = async (event: any) => {
  const service = container.resolve(MyService);
  // 业务逻辑代码
};

4. 可选：修复运行时Reflect缺失问题 #

如果部署后出现Reflect is not defined错误，创建polyfills.ts文件：

import 'reflect-metadata';

然后在CDK的esBuild配置中添加注入参数：

bundling: {
  // 其他配置
  esbuildArgs: {
    '--inject': ['./src/polyfills.ts'],
  },
}

验证方式 #

• 本地用esBuild编译后，检查输出JS文件中是否包含__metadata相关的装饰器元数据代码
• 部署到AWS后，测试Lambda函数是否能正常获取依赖实例，不再返回undefined

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