AWS Cloud9中DynamoDB BatchWriteItem报错：键元素与schema不匹配

核心问题 #

报错The provided key element does not match the schema的本质是：你批量写入的数据中，主键字段的名称或数据类型，和DynamoDB表Movies创建时定义的主键（分区键/排序键）规则不匹配。

排查与修复步骤 #

1. 先确认Movies表的主键结构 #

用AWS CLI执行命令查看表的主键定义：

aws dynamodb describe-table --table-name Movies

输出里的KeySchema区块会明确显示主键信息，比如单主键：

"KeySchema": [
    {
        "AttributeName": "Title",
        "KeyType": "HASH"
    }
]

或者复合主键（分区键+排序键）：

"KeySchema": [
    {
        "AttributeName": "Year",
        "KeyType": "HASH"
    },
    {
        "AttributeName": "Title",
        "KeyType": "RANGE"
    }
]

2. 对比JSON数据与主键规则 #

• 如果表的主键是Title（字符串类型）：检查JSON里的Title字段名是否和表定义完全一致（DynamoDB字段名大小写敏感，比如表定义是title而你写Title就会报错），同时确认类型是S（字符串），你的当前JSON里类型是对的。
• 如果表是复合主键：比如分区键是Year（数字类型N），那你必须在每个Item里补充"Year": {"N": "2022"}这类字段，且类型要和表定义匹配。
• 如果主键不是Title：比如表用MovieID作为分区键，那每个Item都必须包含该字段，且类型符合表的定义。

3. 修正movies.json并重新执行 #

根据表的主键规则调整JSON内容后，再次运行命令：

aws dynamodb batch-write-item --request-items file://movies.json

额外注意事项 #

• 主键字段是写入数据的必填项，缺失或类型错误都会触发该报错。
• 字段名大小写严格匹配，哪怕只差一个大小写字母都会导致不匹配。

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