dynamodb 默认采用“覆盖式更新”，若使用 dynamodbmapper 且未显式配置 savebehavior，仅传入部分属性的更新操作将清空其余字段（如 address），导致数据意外丢失。
dynamodb 默认采用“覆盖式更新”，若使用 dynamodbmapper 且未显式配置 savebehavior，仅传入部分属性的更新操作将清空其余字段（如 address），导致数据意外丢失。
在 Spring Boot 项目中集成 Amazon DynamoDB 时，开发者常借助 AWS SDK for Java 的 DynamoDBMapper（或新版 DynamoDbEnhancedClient）实现对象与表项的映射操作。一个关键但易被忽视的行为是：默认更新策略并非“局部更新”（partial update），而是“全量覆盖”（full replacement）。
以您描述的场景为例：
// 初始写入
{ "id": 1, "name": "gabriel", "address": "xxx" }若后续仅传入：
{ "id": 1, "name": "gabriel" }并调用 mapper.save(item)（未做任何配置），DynamoDBMapper 会将该对象序列化为完整新项，未显式设置的字段（如 address）在序列化后为 null，最终被写入为 NULL 值——而 DynamoDB 在写入 NULL 时实际删除该属性。因此查询结果确实变为：
{ "id": 1, "name": "gabriel" }address 字段彻底丢失。
✅ 正确做法：显式指定 SaveBehavior
使用 DynamoDBMapperConfig.SaveBehavior 控制保存语义。推荐两种安全策略：
- UPDATE_SKIP_NULL_ATTRIBUTES（推荐）：跳过值为 null 的字段，保留原表中对应属性不变。
- UPDATE（v2.2+ 推荐替代方案）：仅更新显式设置的字段，不触碰未赋值字段（需配合 @DynamoDBAttribute 注解及非 null 初始化）。
示例（基于 DynamoDBMapper）：
DynamoDBMapper mapper = new DynamoDBMapper(dynamoDB,
DynamoDBMapperConfig.builder()
.withSaveBehavior(DynamoDBMapperConfig.SaveBehavior.UPDATE_SKIP_NULL_ATTRIBUTES)
.build()
);
User user = new User();
user.setId(1L);
user.setName("gabriel"); // address 未设值 → 跳过更新
mapper.save(user); // address 保持原值，不会被删除⚠️ 注意事项：
- UPDATE_SKIP_NULL_ATTRIBUTES 仅对 null 值生效；若字段被显式设为 "" 或 new ArrayList()，仍会覆盖原值；
- 新版推荐迁移到 DynamoDbEnhancedClient，其 UpdateItemOperation 提供更细粒度的 UpdateExpression 控制（如 set #addr = :val），天然支持真正的局部更新；
- 所有微服务必须统一配置 SaveBehavior，否则协作更新时仍可能引发数据丢失；
- 建议在实体类中为可选字段添加 @DynamoDBIgnore 或合理默认值，并配合单元测试验证更新行为。
总结：DynamoDB 本身不支持“PATCH 语义”的开箱即用更新，框架层的行为完全取决于客户端配置。切勿依赖默认行为处理部分更新——务必显式声明 SaveBehavior，并在多服务协作场景中建立统一的数据变更规范。
