DynamoDB扫描正常但load方法加载单条数据失败求助

可能的原因 #

• 哈希键值不匹配：DynamoDB对键值大小写敏感，且数据类型严格匹配。比如表中存储的是字符串类型的"123"，但代码传入的是数字类型123；或者键值包含控制台不可见的空格、换行符，导致表面一致实际不同。
• 实体类注解配置错误：虽然scan正常，但@DynamoDBHashKey的attributeName可能与表中哈希键的实际名称不一致（比如大小写错误）；或者误将主哈希键用@DynamoDBIndexHashKey注解标记。
• Mapper内部类型转换问题：实体类属性的setter参数类型与DynamoDB存储的数据类型不兼容，导致Mapper无法解析返回数据，最终返回null。

调试方案 #

• 对比哈希键的实际值：从scan结果中取出目标记录的哈希键值，与传入load方法的primaryIndex做逐字符对比（包括长度、大小写、特殊字符）。可以将两者都转换成十六进制字符串，排查隐藏字符问题。
• 验证实体类注解：确认@DynamoDBHashKey的attributeName与DynamoDB控制台显示的哈希键名称完全一致；检查实体类是否正确标记主哈希键，而非索引哈希键。
• 用低级API直接查询：绕过DynamoDB Mapper，使用AmazonDynamoDB客户端的getItem方法测试，确认是否能获取数据：

// 替换成你的哈希键名称和值
String hashKeyName = "yourHashKeyAttributeName";
AttributeValue hashKeyValue = new AttributeValue().withS(primaryIndex.toString());

GetItemRequest request = new GetItemRequest()
    .withTableName(tableName)
    .withKey(Collections.singletonMap(hashKeyName, hashKeyValue));

GetItemResult result = amazonDynamoDB.getItem(request);
System.out.println("查询结果: " + result.getItem());

如果此方法能拿到数据，说明问题出在Mapper的配置或实体类的属性映射上；如果拿不到，证明键值确实不匹配。

• 开启Mapper调试日志：将DynamoDB Mapper的日志级别设为DEBUG，查看实际发送给DynamoDB的请求参数，对比键值、表名等是否正确。
• 检查属性setter方法：确保所有属性的setter是public修饰，且参数类型与DynamoDB存储的数据类型匹配（比如表中是N类型，setter参数应为Integer/Long而非String）。

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