如何在AWS CDK Lambda中使用Esbuild插件？

针对你遇到的AWS CDK中Esbuild无法通过CLI配置插件的限制，同时满足替换import.meta.dirname的需求，有两种可行的规避方案：

方法一：直接在CDK配置中注入Esbuild插件 #

新版AWS CDK的NodejsFunction组件允许在esbuild.buildOptions中直接传入Esbuild插件，无需依赖CLI参数或外部配置文件。你可以编写自定义插件实现import.meta.dirname的替换：

import * as cdk from 'aws-cdk-lib';
import { NodejsFunction } from 'aws-cdk-lib/aws-lambda-nodejs';
import { Plugin } from 'esbuild';
import * as fs from 'fs';
import * as path from 'path';

// 自定义插件：构建阶段替换import.meta.dirname为文件实际路径
const replaceImportMetaPlugin: Plugin = {
  name: 'replace-import-meta-dirname',
  setup(build) {
    build.onLoad({ filter: /\.(ts|js)$/ }, async (args) => {
      const content = await fs.promises.readFile(args.path, 'utf8');
      const dirPath = path.dirname(args.path);
      // 将所有import.meta.dirname替换为当前文件的绝对路径字符串
      const modifiedContent = content.replace(
        /import\.meta\.dirname/g,
        JSON.stringify(dirPath)
      );
      return { contents: modifiedContent, loader: args.path.endsWith('.ts') ? 'ts' : 'js' };
    });
  },
};

// 在Lambda函数配置中使用该插件
new NodejsFunction(this, 'TargetLambda', {
  entry: 'src/handler.ts',
  runtime: cdk.aws_lambda.Runtime.NODEJS_20_X,
  esbuild: {
    buildOptions: {
      plugins: [replaceImportMetaPlugin],
    },
  },
});

方法二：通过Esbuild配置文件配合CDK的esbuildArgs加载 #

如果你偏好使用独立的Esbuild配置文件，可以先在配置文件中定义插件，再通过CDK的esbuildArgs指定配置文件路径：

1. 创建Esbuild配置文件esbuild.config.js：

const fs = require('fs').promises;
const path = require('path');

module.exports = {
  plugins: [
    {
      name: 'replace-import-meta-dirname',
      setup(build) {
        build.onLoad({ filter: /\.(ts|js)$/ }, async (args) => {
          const content = await fs.readFile(args.path, 'utf8');
          const dirPath = path.dirname(args.path);
          const modifiedContent = content.replace(
            /import\.meta\.dirname/g,
            JSON.stringify(dirPath)
          );
          return { contents: modifiedContent, loader: args.path.endsWith('.ts') ? 'ts' : 'js' };
        });
      },
    },
  ],
};

2. 在CDK代码中指定该配置文件：

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

new NodejsFunction(this, 'TargetLambda', {
  entry: 'src/handler.ts',
  runtime: cdk.aws_lambda.Runtime.NODEJS_20_X,
  esbuild: {
    esbuildArgs: {
      '--config': './esbuild.config.js',
    },
  },
});

注意事项 #

• 确保使用的AWS CDK版本不低于v2.50.0，该版本开始buildOptions正式支持plugins字段。
• 构建阶段替换的是本地开发环境中的文件路径，如果需要Lambda运行时的路径，建议改用process.cwd()或通过环境变量传递，避免路径不匹配问题。

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