在 Spring 项目中使用 DynamoDB Mapper 更新实体时，若仅传入部分字段（如省略 address），默认行为会覆盖整个项，导致未显式设置的属性被置为 null 并写入表中，从而造成数据丢失。
在 spring 项目中使用 dynamodb mapper 更新实体时，若仅传入部分字段（如省略 `address`），默认行为会覆盖整个项，导致未显式设置的属性被置为 `null` 并写入表中，从而造成数据丢失。
DynamoDB 本身是无模式的键值/文档数据库，不支持传统 SQL 的“局部更新”语义。当通过 AWS SDK 的 DynamoDBMapper（尤其在 Spring Data DynamoDB 或旧版 aws-java-sdk-dynamodb 中）执行 save() 操作时，默认采用 SaveBehavior.UPDATE_SKIP_NULL_ATTRIBUTES 以外的行为——实际上，早期版本（v1.x）默认使用 UPDATE 行为，但会将未设值的字段视为 null，并将其写入表中，覆盖原有值。这正是你遇到 address 字段消失的根本原因。
例如：
// 初始插入
User user = new User();
user.setId(1L);
user.setName("gabriel");
user.setAddress("xxx");
mapper.save(user); // 写入: {id: 1, name: "gabriel", address: "xxx"}
// 后续仅更新 name
User update = new User();
update.setId(1L);
update.setName("gabriel-updated");
// ❌ address 字段未设置 → 默认变为 null
mapper.save(update); // 实际写入: {id: 1, name: "gabriel-updated", address: null}查询结果中 address 将为空（DynamoDB 中该属性被显式删除或置空，取决于配置）。
✅ 正确解决方案：显式配置 SaveBehavior
自 AWS SDK for Java v1.11.513 起，DynamoDBMapper 支持 SaveBehavior 枚举，推荐使用：
| 行为 | 说明 | 是否避免丢失 |
|---|---|---|
| SAVE_ALWAYS（默认） | 所有字段全量写入，未设值字段写 null → 会导致丢失 | ❌ |
| UPDATE_SKIP_NULL_ATTRIBUTES | 仅写入非 null 字段，null 字段跳过，保留原值 | ✅ 推荐 |
| CLOBBER | 强制覆盖全部属性（含 null） | ❌ 风险最高 |
配置方式（Spring Boot 示例）：
@Configuration
public class DynamoDBConfig {
@Bean
public DynamoDBMapper dynamoDBMapper(AmazonDynamoDB amazonDynamoDB) {
DynamoDBMapperConfig config = DynamoDBMapperConfig.builder()
.withSaveBehavior(DynamoDBMapperConfig.SaveBehavior.UPDATE_SKIP_NULL_ATTRIBUTES)
.build();
return new DynamoDBMapper(amazonDynamoDB, config);
}
}⚠️ 注意事项：
- UPDATE_SKIP_NULL_ATTRIBUTES 仅跳过 null 值字段，不会跳过 0、false 或空字符串（它们是有效值），因此业务上需谨慎判空逻辑；
- 若需真正意义上的“原子局部更新”（如 ADD, DELETE, SET 表达式），应弃用 save()，改用 DynamoDBMapper#updateItem() 配合 UpdateItemSpec，或直接使用 AmazonDynamoDB.updateItem() 构建 UpdateExpression；
- Spring Data DynamoDB（社区维护库）已停止积极更新，建议新项目优先采用 AWS SDK v2 + DynamoDbEnhancedClient，其 updateItem() 默认更安全，并原生支持 UpdateExpression 和条件更新。
总结：DynamoDB 的 save() 不是“PATCH”，而是“UPSERT with null semantics”。务必通过 SaveBehavior.UPDATE_SKIP_NULL_ATTRIBUTES 显式启用安全更新策略，并在跨微服务协作场景中统一 mapper 配置，避免因隐式覆盖引发的数据一致性事故。
