AWS V3 DynamoDB BatchWriteItem数组字段写入失败问题求助

你遇到的问题核心是DynamoDB对数据类型有严格要求，数组字段必须转换成它规定的List（L类型）结构，每个元素也需要对应到DynamoDB的类型标记（比如字符串用S、对象用M）。直接传普通JS数组会因为类型不匹配导致写入失败，下面是具体解决方法：

方法1：手动转换为DynamoDB类型结构 #

写一个工具函数，把普通JS值递归转换成DynamoDB要求的类型格式，数组会被转换成L类型，其中每个元素都经过类型转换：

function toDynamoDBValue(value) {
  if (typeof value === 'string') {
    return { S: value };
  }
  if (typeof value === 'number') {
    return { N: value.toString() };
  }
  if (typeof value === 'boolean') {
    return { BOOL: value };
  }
  if (value === null) {
    return { NULL: true };
  }
  if (Array.isArray(value)) {
    return { L: value.map(item => toDynamoDBValue(item)) };
  }
  if (typeof value === 'object') {
    const mappedObj = {};
    Object.entries(value).forEach(([key, val]) => {
      mappedObj[key] = toDynamoDBValue(val);
    });
    return { M: mappedObj };
  }
  throw new Error(`不支持的数据类型：${typeof value}`);
}

然后构造批量写入请求时，用这个函数转换pets数组：

import { DynamoDBClient, BatchWriteItemCommand } from "@aws-sdk/client-dynamodb";

const client = new DynamoDBClient({ region: "你的区域" });
const people = [
  { id: "1", location: "北京", pets: [{ name: "旺财", type: "狗" }, { name: "咪咪", type: "猫" }] },
  // 其他人员数据
];

const batchParams = {
  RequestItems: {
    "你的表名": people.map(item => ({
      PutRequest: {
        Item: {
          id: { S: item.id },
          location: { S: item.location },
          pets: toDynamoDBValue(item.pets) // 转换数组为DynamoDB List类型
        }
      }
    }))
  }
};

await client.send(new BatchWriteItemCommand(batchParams));

方法2：使用DynamoDB Document Client（更简便） #

如果用DynamoDBDocumentClient，它会自动帮你把普通JS类型转换成DynamoDB的类型格式，不需要手动加L/M标记，直接传普通数组即可：

import { DynamoDBClient } from "@aws-sdk/client-dynamodb";
import { DynamoDBDocumentClient, BatchWriteCommand } from "@aws-sdk/lib-dynamodb";

const client = new DynamoDBClient({ region: "你的区域" });
const docClient = DynamoDBDocumentClient.from(client);

const batchParams = {
  RequestItems: {
    "你的表名": people.map(item => ({
      PutRequest: {
        Item: {
          id: item.id,
          location: item.location,
          pets: item.pets // 直接传普通JS数组
        }
      }
    }))
  }
};

await docClient.send(new BatchWriteCommand(batchParams));

错误原因说明 #

• 用pets: { M: item.pets }无效：M是DynamoDB的对象类型标记，不是数组类型，所以数组不能用M。
• 用pets: { L: item.pets }报错：L要求数组内的每个元素都是DynamoDB类型对象（比如{ S: "旺财" }），而你传的是普通JS对象，SDK无法识别，所以触发读取0属性的错误。

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