通过CDK部署Lambda调用S3 MRAP HeadObject时遇signature-v4-crt报错

可能的原因及解决方案 #

1. 代码变量名笔误 #

查看你的代码示例，初始化的S3客户端变量是s3，但调用发送命令时用的是client.send，client未定义，这会直接抛出ReferenceError，可能你混淆了这个错误和签名包的报错。

解决方法：
修正代码中的变量名：

await s3.send(
  new HeadObjectCommand({
    Key: key,
    Bucket: bucket,
  })
)

2. ESBuild Tree Shaking 移除了签名包 #

如果你的CDK项目使用ESBuild打包Lambda代码（默认配置），ESBuild会自动移除未被直接引用的代码。import '@aws-sdk/signature-v4-crt'属于仅注册无直接调用的代码，很可能被Tree Shaking剔除。

解决方法：

• 在CDK的Lambda构建配置中，添加ESBuild的inject配置强制引入该模块：
  示例CDK代码：

  new lambda.NodejsFunction(this, 'MyLambda', {
    entry: 'src/index.ts',
    bundling: {
      inject: ['src/force-imports.ts'],
    },
  });
  

  其中force-imports.ts内容为：

  import '@aws-sdk/signature-v4-crt';
  

• 或者禁用Tree Shaking（不推荐，会增加包体积），将minify设为false。

3. 依赖版本不匹配 #

确保@aws-sdk/client-s3和@aws-sdk/signature-v4-crt的版本完全一致，版本不一致会导致签名器无法正确注册。

解决方法：

• 在package.json中指定两者为相同版本，例如：

  {
    "dependencies": {
      "@aws-sdk/client-s3": "3.422.0",
      "@aws-sdk/signature-v4-crt": "3.422.0"
    }
  }
  

• 重新执行npm install或yarn install同步依赖。

4. 未显式配置S3Client签名参数 #

虽然SDK会自动注册签名器，但针对多区域访问点，有时需要显式指定签名版本和区域。

解决方法：
初始化S3Client时显式设置参数：

const s3 = new S3Client({
  region: 'us-east-1', // MRAP可指定任意支持的区域
  signatureVersion: 'v4',
});

5. Lambda运行环境不兼容 #

@aws-sdk/signature-v4-crt依赖AWS CRT二进制文件，需要确保Lambda运行环境支持：

• 运行时选择nodejs18.x或nodejs20.x（Node.js 16+版本均可）
• 架构优先选择x86_64，若使用arm64需确保安装的包包含对应架构的二进制文件

6. CDK打包未正确包含依赖包 #

如果CDK打包配置未正确包含node_modules，即使本地有该包，部署到Lambda的代码中也可能缺失。

解决方法：
使用CDK的fromAsset方式打包并包含完整依赖：

new lambda.Function(this, 'MyLambda', {
  code: lambda.Code.fromAsset('src', {
    bundling: {
      image: lambda.Runtime.NODEJS_18_X.bundlingImage,
      command: [
        'bash', '-c',
        'npm install && cp -r . /asset-output'
      ],
    },
  }),
  runtime: lambda.Runtime.NODEJS_18_X,
  handler: 'index.handler',
});

额外验证步骤 #

• 下载部署后的Lambda代码包，解压确认node_modules/@aws-sdk/signature-v4-crt目录完整存在
• 在代码中添加日志console.log(require.resolve('@aws-sdk/signature-v4-crt'))，验证模块能被正确加载

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