在 Spring 项目中使用 DynamoDB Mapper 更新实体时，若仅传入部分字段（如省略 address），默认行为会覆盖整个项，导致未传字段被清空——这是由 SaveBehavior 默认配置决定的，而非 DynamoDB 服务端限制。
在 spring 项目中使用 dynamodb mapper 更新实体时，若仅传入部分字段（如省略 `address`），默认行为会覆盖整个项，导致未传字段被清空——这是由 `savebehavior` 默认配置决定的，而非 dynamodb 服务端限制。
在基于 Spring Boot 的微服务架构中，多个服务共用同一 DynamoDB 表时，字段意外丢失（如 address 属性归零或为空）是典型且高危的问题。根本原因往往不在业务逻辑本身，而在于 AWS SDK for Java 中 DynamoDB Mapper 的持久化语义设计。
DynamoDB 本身是无模式（schema-less）的键值/文档数据库，它不支持“局部更新”语义的原生 PUT 操作：当你调用 mapper.save(entity)，SDK 默认执行的是 PUT 操作（即全量替换），而非 UPDATE（条件式属性更新）。这意味着：
- 若你构造一个仅含 id 和 name 的实体对象并调用 save()；
- 即使原记录中存在 address: "xxx"，该字段也会在保存后彻底消失；
- 最终表中仅保留你显式设置的字段（id, name），其余属性被静默丢弃。
✅ 正确做法：显式配置 SaveBehavior
自 AWS SDK v1.11.512 起，DynamoDBMapperConfig.SaveBehavior 提供了四种策略，推荐根据场景选择：
| 行为 | 配置值 | 说明 | 适用场景 |
|---|---|---|---|
| UPDATE | SaveBehavior.UPDATE | 仅更新非 null 字段，null/未赋值字段保持原值不变 | ✅ 多服务协作、局部更新首选 |
| CLOBBER | SaveBehavior.CLOBBER（默认） | 全量覆盖，未设字段置为 null 或删除 | ⚠️ 易引发数据丢失，不建议生产使用 |
| APPEND_SET | SaveBehavior.APPEND_SET | 仅对 Set 类型字段追加（不覆盖） | 特定集合操作 |
| CLOBBER_AND_USE_NULLS | — | 将 null 值显式写入并覆盖原字段 | 极少使用 |
? 示例：在 Spring Boot 中启用 UPDATE 行为
@Configuration
public class DynamoDBConfig {
@Bean
public DynamoDBMapper dynamoDBMapper(AmazonDynamoDB amazonDynamoDB) {
DynamoDBMapperConfig config = DynamoDBMapperConfig.builder()
.withSaveBehavior(DynamoDBMapperConfig.SaveBehavior.UPDATE) // ? 关键配置
.build();
return new DynamoDBMapper(amazonDynamoDB, config);
}
}⚠️ 注意事项：
- SaveBehavior.UPDATE 仅对 @DynamoDBAttribute 标注的非 null 字段生效；若字段被设为 null，仍会被清除（DynamoDB 中 null 等价于删除）；
- 如需真正安全的“部分更新”，应改用 DynamoDBMapper#updateItem() + UpdateItemSpec，或更现代的 AWS SDK for Java v2 的 DynamoDbTable.updateItem()（支持 UpdateExpression 语法，精确控制每个属性）；
- 在微服务间共享实体类时，务必统一 SaveBehavior 配置，并通过集成测试验证字段保留行为；
- 建议配合 @DynamoDBAutoGeneratedTimestamp 和乐观锁（@DynamoDBVersionAttribute）增强数据一致性。
? 总结：避免 DynamoDB 字段丢失的核心原则是——绝不依赖默认 CLOBBER 行为处理部分更新。主动配置 SaveBehavior.UPDATE 是 Spring + DynamoDB 项目的基础健壮性保障。对于复杂更新逻辑（如原子计数器、条件写入），请直接使用底层 UpdateItem API，以获得完全可控的数据变更语义。
