DynamoDB batchWrite遇键元素不匹配错误，求marshall正确用法

问题 #

在AWS DynamoDB的batchWrite操作中触发错误：The provided key element does not match the schema。使用以下代码批量插入数据时出现该问题：

module.exports.saveToDynamoDB = async (myData) => {
  const tableName = process.env.MY_TABLE;

  const putRequests = myData.map((data) => ({
    PutRequest: {
      Item: AWS.DynamoDB.Converter.marshall(data),
    },
  }));

  const params = {
    RequestItems: {
      [tableName]: putRequests,
    },
  };

  try {
    await dynamoDb.batchWrite(params).promise();

    return {
      status: 'SUCCESS',
      message: `${myData.length} data saved to the database`,
    };

  } catch (error) {
    throw new Error(error.message);
  }
};

我误以为AWS.DynamoDB.Converter.marshall应该将数值转换为"N": 1的格式，但实际转换后数值会被转为字符串形式（比如"N": "1"），怀疑这是报错原因。

示例输入数据：

[
    {
        "id": 1,
        "name": "first",
        "rating": 100
    },
    {
        "id": 2,
        "name": "second",
        "rating": 99
    }
]

转换后的请求参数：

{
  "RequestItems": {
    "myTable": [
      {
        "PutRequest": {
          "Item": {
            "id": {
              "N": "1"
            },
            "name": {
              "S": "first"
            },
            "rating": {
              "N": "100"
            }
          }
        }
      },
      {
        "PutRequest": {
          "Item": {
            "id": {
              "N": "2"
            },
            "name": {
              "S": "second"
            },
            "rating": {
              "N": "99"
            }
          }
        }
      }
    ]
  }
}

解决方案 #

1. 纠正核心误解：marshall的输出是合规的 #

DynamoDB原生API格式中，数值类型（Number）必须以字符串形式存储，这是为了避免大数值的精度丢失问题。你看到的"N": "1"是完全符合DynamoDB规范的格式，不是错误。

2. 错误的真实原因：主键类型与表Schema不匹配 #

The provided key element does not match the schema错误的本质是：你传入的主键（比如示例中的id）的数据类型，与DynamoDB表中定义的主键类型不一致。

常见场景：

• 如果表主键id定义为字符串类型（S），但marshall后生成的是数值类型（N），会触发错误；
• 反之，如果表主键id定义为数值类型（N），但输入数据中的id是字符串（比如"id": "1"），同样会报错。

3. 正确使用marshall的方法 #

AWS.DynamoDB.Converter.marshall的默认行为是正确的，它会根据输入数据的JS类型自动映射为对应的DynamoDB类型：

• JS数字 → DynamoDB N类型（值为字符串）
• JS字符串 → DynamoDB S类型
• JS布尔值 → DynamoDB BOOL类型

如果需要强制转换类型，可以通过第二个参数options配置，比如：

// 自定义转换规则示例
const item = AWS.DynamoDB.Converter.marshall(
  { id: 1 },
  { convertEmptyValues: false, removeUndefinedValues: true }
);

多数场景下默认配置即可满足需求，无需额外修改。

4. 修复步骤 #

1. 登录AWS控制台，查看目标DynamoDB表的Schema，确认主键（分区键/排序键）的类型；
2. 确保输入数据中主键字段的JS类型与表Schema定义一致：
   • 若表主键是S类型，输入数据的主键应为字符串（比如"id": "1"）；
   • 若表主键是N类型，输入数据的主键应为数字（比如"id": 1）；
3. 重新执行代码即可解决错误。

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