使用AWS CLI向DynamoDB批量写入JSON数据时遇格式错误求助

核心问题：JSON格式不符合DynamoDB要求 #

batch-write-item对--request-items的JSON结构有严格规范，必须遵循表名作为顶级键，值为包含PutRequest/DeleteRequest的数组，且每个Item的属性必须指定DynamoDB数据类型（如S=字符串、N=数字、BOOL=布尔值等）。

正确JSON格式示例 #

假设你的表名为SensorData，正确的sensor_items.json结构如下：

{
  "SensorData": [
    {
      "PutRequest": {
        "Item": {
          "sensorId": { "S": "sensor_001" },
          "timestamp": { "N": "1699999999" },
          "temperature": { "N": "24.3" },
          "location": { "S": "room_101" }
        }
      }
    },
    {
      "PutRequest": {
        "Item": {
          "sensorId": { "S": "sensor_002" },
          "timestamp": { "N": "1700000000" },
          "temperature": { "N": "25.1" },
          "location": { "S": "room_102" }
        }
      }
    }
    // 其余18条数据依此格式添加
  ]
}

常见错误排查点 #

• 缺少数据类型标识：直接写"temperature": 24.3而不是"temperature": { "N": "24.3" }，DynamoDB无法识别原始值类型。
• 结构层级错误：比如把PutRequest直接放在数组里，没有嵌套在对象中；或者顶级键不是表名。
• JSON语法错误：遗漏逗号、引号不匹配、括号/大括号未闭合，这类错误会直接导致解析失败。
• 表名大小写不匹配：DynamoDB表名大小写敏感，JSON中的顶级键必须和实际表名完全一致。

调试与验证步骤 #

1. 校验JSON语法：在Cloud9终端执行jq . sensor_items.json，如果JSON格式合法，会输出格式化后的内容；若有错误，会提示具体错误位置（比如某行某列的语法问题）。
2. 单条数据测试：先写1条符合格式的数据到JSON文件，执行aws dynamodb batch-write-item --request-items file://sensor_items.json，确认成功后再批量添加剩余数据。
3. 开启调试模式：执行aws dynamodb batch-write-item --request-items file://sensor_items.json --debug，查看详细的错误日志，定位JSON解析失败的具体原因。

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