使用NodeJS aws-sdk调用DynamoDB getItem时出现Schema匹配错误

环境 #

使用NodeJS搭配aws-sdk: "^2.1692.0"进行DynamoDB操作测试

问题描述 #

• 目标：获取CUSTOMER_LIST表中的条目
• 用putItem存储数据成功，参数如下：

var params = {
  TableName: "CUSTOMER_LIST",
  Item: {
    CUSTOMER_ID: { N: "001" },
    CUSTOMER_NAME: { S: "Richard Roe" },
  },
};

• 调用getItem或删除操作时，使用以下参数抛出错误：

var params = {
  TableName: 'CUSTOMER_LIST',
  Key: {
    "CUSTOMER_ID": { N: "001" },
  },
  ProjectionExpression: 'CUSTOMER_NAME',
};

错误信息：

Error ValidationException: The provided key element does not match the schema

原因分析 #

这个错误的核心是传入的Key不符合表的主键定义，常见两种情况：

1. 表为复合主键（分区键+排序键），但查询/删除时只传入了分区键，缺少排序键
2. 传入的主键字段数据类型与表定义的类型不匹配

解决方案 #

1. 确认表的主键结构
   登录AWS控制台，进入DynamoDB服务，找到CUSTOMER_LIST表，查看主键是单一分区键还是复合主键，以及每个主键字段的类型（字符串S/数字N等）。

2. 根据主键定义调整参数

   • 若为单一分区键且类型为字符串(S)：
     将Key中的CUSTOMER_ID类型改为S，同时注意：若之前用N类型存入的数据，主键实际是数字1，需用{ N: "1" }才能查询到：

     var params = {
       TableName: 'CUSTOMER_LIST',
       Key: {
         "CUSTOMER_ID": { S: "001" },
       },
       ProjectionExpression: 'CUSTOMER_NAME',
     };
     

   • 若为复合主键（如分区键CUSTOMER_ID+排序键XXX）：
     必须同时传入完整的主键字段和对应值，示例如下：

     var params = {
       TableName: 'CUSTOMER_LIST',
       Key: {
         "CUSTOMER_ID": { N: "001" },
         "XXX": { S: "对应排序键值" }
       },
       ProjectionExpression: 'CUSTOMER_NAME',
     };
     

3. 规范数据写入
   后续使用putItem时，严格按照表定义的主键类型传入数据，避免因类型不匹配导致的后续查询/删除异常。

参考文档：AWS SDK for JavaScript v2开发者指南 - DynamoDB表读写示例

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