AWS Lambda读取DynamoDB报错：Cannot read properties of undefined (reading '0')

问题描述 #

我用AWS SDK v3编写了一个处理GET请求的Lambda函数，用于从DynamoDB读取数据，代码片段如下：

const {httpMethod, body, pathParameters} = event;
const {id} = pathParameters;

if (httpMethod === 'GET') {
  // READ operation
  const params = {
    TableName: 'Emp_Basic',
    Key: {id}
  };
  const command = new GetItemCommand(params);
  const result = await dynamoDBClient.send(command);

  if (!result.Item) {
    return {
      statusCode: 404,
      body: JSON.stringify({message: 'Item not found'})
    };
  }

  return {
    statusCode: 200,
    body: JSON.stringify(result.Item)
  };
}

理论上应该返回DynamoDB中的数据，但测试时出现“Cannot read properties of undefined (reading '0')”错误，无法定位问题原因。

可能的原因及解决方案 #

1. pathParameters未定义或缺失 #

报错里的“reading '0'”通常和类数组对象的访问有关。当你解构pathParameters时，如果event对象里根本没有这个属性，或者它的值是undefined，执行const {id} = pathParameters会触发内部遍历错误，表现为这个模糊的提示。

修复方法：
在解构前先检查pathParameters和id是否存在：

const {httpMethod, body, pathParameters} = event;
if (!pathParameters?.id) {
  return {
    statusCode: 400,
    body: JSON.stringify({message: '缺少必填路径参数：id'})
  };
}
const {id} = pathParameters;

2. DynamoDB Key的数据类型不匹配 #

DynamoDB是强类型数据库，如果你的表中id字段是数字类型，但请求传入的id是字符串（API Gateway默认会把路径参数转为字符串），执行GetItemCommand时可能触发内部解析错误，最终表现为这个报错。

修复方法：
根据你使用的客户端类型调整Key格式：

• 如果用的是基础DynamoDB客户端（@aws-sdk/client-dynamodb），必须显式指定数据类型：

  const params = {
    TableName: 'Emp_Basic',
    Key: {
      id: { S: id } // 如果id是数字类型，改用 { N: id.toString() }
    }
  };
  

• 如果用的是DocumentClient（@aws-sdk/lib-dynamodb），用GetCommand替代GetItemCommand，可以直接传入原生JS类型：

  const { GetCommand } = require("@aws-sdk/lib-dynamodb");
  // ...
  const params = {
    TableName: 'Emp_Basic',
    Key: { id }
  };
  const command = new GetCommand(params);
  

3. dynamoDBClient未正确初始化 #

如果dynamoDBClient是undefined或者初始化错误，调用send()方法时会触发内部错误，表现为这个报错。

修复方法：
确保客户端已使用正确的AWS区域初始化：

const { DynamoDBClient } = require("@aws-sdk/client-dynamodb");
// 如果用DocumentClient：
// const { DynamoDBDocumentClient } = require("@aws-sdk/lib-dynamodb");

const dynamoDBClient = new DynamoDBClient({
  region: "你的AWS区域" // 例如：us-east-1
});
// DocumentClient初始化方式：
// const dynamoDBClient = DynamoDBDocumentClient.from(new DynamoDBClient({ region: "你的AWS区域" }));

4. API Gateway请求结构不符合预期 #

如果Lambda是由API Gateway触发的，event对象的结构可能和你预期的不一样，比如pathParameters嵌套在requestParameters这类字段下，导致解构失败。

修复方法：
测试时打印完整的event对象，确认pathParameters的实际位置：

console.log("完整event对象:", JSON.stringify(event));

根据实际结构调整解构代码，比如如果pathParameters在event.requestContext.pathParameters下，就修改对应的解构路径。

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