使用原生JavaScript数据类型调用AWS SDK操作DynamoDB为何失败？

你遇到的问题本质是DynamoDB底层API对数据格式的强要求：

1. { "S": <value> }是什么？ #

这是DynamoDB定义的原生数据类型表示格式，每个键是数据类型的缩写，值是对应类型的内容：

• S：代表字符串（String）
• N：代表数字（Number，注意必须传字符串格式的数字，比如{ "N": "123" }）
• BOOL：布尔值（{ "BOOL": true }）
• L：列表（数组，{ "L": [ { "S": "a" }, { "N": "1" } ] }）
• M：嵌套对象（映射，{ "M": { "name": { "S": "Alice" } } }）
  还有二进制B、集合类型等其他格式，都是DynamoDB用来明确区分数据类型的标准结构。

2. 为什么必须用它？ #

你使用的DynamoDBClient是直接和DynamoDB底层REST API交互的客户端，这个API要求所有数据必须携带明确的类型标识——因为DynamoDB是强类型数据库，比如它会严格区分字符串"11111"和数字11111，而原生JavaScript的类型在网络传输时无法被DynamoDB自动准确推断，直接传原生JS值会导致API解析失败，也就是你看到的TypeError。

更简便的替代方案 #

如果觉得这种格式太繁琐，可以使用DynamoDB Document Client（@aws-sdk/lib-dynamodb包），它会自动帮你在原生JS类型和DynamoDB格式之间做转换，不用手动写{ "S": ... }这类结构：

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

const client = new DynamoDBClient({});
const docClient = DynamoDBDocumentClient.from(client);

await docClient.send(
  new QueryCommand({
    TableName: tableName,
    KeyConditionExpression: "zipcode = :zipcode",
    ExpressionAttributeValues: {
      ":zipcode": "11111" // 直接用原生JS字符串即可
    },
    ConsistentRead: true
  })
);

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