当dynamodb表的主键（如id）定义为数字类型（n）时，java sdk必须显式指定数值格式，不能直接用字符串构造attributevalue，否则会触发“type mismatch”错误。
当dynamodb表的主键（如id）定义为数字类型（n）时，java sdk必须显式指定数值格式，不能直接用字符串构造attributevalue，否则会触发“type mismatch”错误。
DynamoDB中主键的类型由表结构（Schema）严格定义。若表的主键属性 `Id` 被定义为**Number类型（N）**，则写入时必须提供符合该类型的值——即使用 `AttributeValue.withN()` 方法传入数值字符串（如 `"123"`），而非直接传入字符串对象或整数对象。你遇到的错误：
One or more parameter values were invalid: Type mismatch for key Id expected: N actual: S
明确指出：DynamoDB期望 Id 是数字（N），但实际收到的是字符串（S）。这是因为 new AttributeValue(id) 中 id 是 String 类型，SDK默认将其序列化为字符串类型（S），即使内容是纯数字（如 "42"）。
✅ 正确做法：使用 withN() 显式声明数值类型：
protected PutItemResult insert(String table, String id, String key, String value) {
PutItemRequest request = new PutItemRequest()
.withTableName(table)
.addItemEntry("Id", new AttributeValue().withN(id)) // ✅ id作为数字字符串传入
.addItemEntry(key, new AttributeValue(value));
return dynamoDbClient.putItem(request);
}⚠️ 注意事项：
-
withN()接收 字符串形式的数字（如"100"、"-5"、"3.14"），而非int或Integer；若传入非数值字符串（如"abc"），运行时将抛出AmazonServiceException。 - 若需传入
Integer变量，应先转换为字符串：.withN(String.valueOf(idInt))。 - 不要尝试
new AttributeValue().withN(String.valueOf(123))的冗余写法——简洁写法.withN("123")更清晰安全。 - 若主键实际应为字符串类型（如 UUID），则应在建表时明确定义为
S类型，并保持new AttributeValue(id)即可；类型必须与表 Schema 严格一致。
? 总结：DynamoDB 的强类型要求体现在 SDK 的序列化层面。AttributeValue 不自动推断类型，必须通过 withN()、withS()、withBOOL() 等方法显式指定。检查表描述（describeTable）确认主键类型，再选择对应构建方式，是避免此类类型错误的关键实践。
