NestJS项目中调用Lambda时client-context为空的问题求助

1. 确保调用方正确构造client-context参数 #

AWS Lambda要求client-context必须是JSON对象序列化为字符串后再进行Base64编码的值，不能直接传入JSON对象。以下是Node.js环境下的正确示例：

使用AWS SDK v3 #

import { LambdaClient, InvokeCommand } from "@aws-sdk/client-lambda";

const lambdaClient = new LambdaClient({ region: "你的区域" });

async function invokeTargetLambda() {
  const clientContextObj = {
    custom: { /* 你的自定义参数 */ },
    env: { /* 环境参数 */ }
  };
  // 序列化为字符串并Base64编码
  const clientContextBase64 = Buffer.from(JSON.stringify(clientContextObj)).toString("base64");

  const command = new InvokeCommand({
    FunctionName: "目标Lambda函数名",
    InvocationType: "RequestResponse", // 按需选同步/异步
    ClientContext: clientContextBase64, // SDK v3为小驼峰参数名
    Payload: Buffer.from(JSON.stringify({ /* 请求体参数 */ }))
  });

  const response = await lambdaClient.send(command);
  // 处理响应
}

使用AWS SDK v2 #

const AWS = require('aws-sdk');
const lambda = new AWS.Lambda({ region: "你的区域" });

async function invokeTargetLambda() {
  const clientContextObj = {
    custom: { /* 你的自定义参数 */ },
    env: { /* 环境参数 */ }
  };
  const clientContextBase64 = Buffer.from(JSON.stringify(clientContextObj)).toString("base64");

  const params = {
    FunctionName: "目标Lambda函数名",
    InvocationType: "RequestResponse",
    ClientContext: clientContextBase64, // SDK v2为大驼峰参数名
    Payload: JSON.stringify({ /* 请求体参数 */ })
  };

  const response = await lambda.invoke(params).promise();
  // 处理响应
}

2. 确认目标Lambda正确获取client-context #

在NestJS的Lambda处理逻辑中，client-context并不在请求event对象里，而是存在于Lambda的context对象中。你需要从context.clientContext中读取：

// 目标Lambda的入口函数
export const handler = async (event: any, context: any) => {
  // 获取client-context
  const clientContext = context.clientContext;
  if (clientContext?.custom) {
    // 使用custom中的参数进行验证
  }
  // 后续NestJS处理逻辑
};

如果你的NestJS应用是通过@nestjs/platform-lambda构建的，可以在控制器中通过@Ctx()装饰器获取Lambda context：

import { Controller, Post, Ctx } from '@nestjs/common';
import { Context } from 'aws-lambda';

@Controller()
export class AppController {
  @Post()
  async handleRequest(@Ctx() context: Context) {
    const clientContext = context.clientContext;
    // 验证clientContext参数
  }
}

3. 排查Serverless框架或插件的影响 #

• 如果使用serverless-offline本地测试，该插件对client-context的处理可能和生产环境不一致，建议直接部署到AWS环境测试，或检查插件版本是否存在相关bug。
• 检查是否有其他Serverless插件（如请求拦截、日志插件）修改了Lambda的输入参数，导致client-context被丢弃。

4. 验证权限与IAM配置 #

确保调用方Lambda的IAM角色拥有lambda:InvokeFunction权限，并且目标Lambda的资源策略允许调用方角色触发。虽然调用已能触发，但权限配置异常也可能导致参数传递异常。

内容的提问来源于stack exchange，提问作者Damián LLuch Castelli