DynamoDB-Toolbox中created与modified时间戳的注意事项

在使用DynamoDB-Toolbox进行数据操作时，开发者可能会遇到一个关于时间戳的常见问题：当使用put方法更新已有实体时，created字段会被更新为与modified字段相同的值。这实际上是一个设计行为，但可能不符合部分开发者的预期。

核心问题解析

DynamoDB-Toolbox提供了两种主要的数据操作方法：

1. put - 完全替换操作
2. update - 部分更新操作

put操作在DynamoDB中的语义是"完全替换"，它会用新提供的项目完全替换现有项目。因此，当执行put时，工具会重新设置所有字段，包括created时间戳。这解释了为什么created会被更新为当前时间。

正确的实践方式

当需要更新已有实体时，应该优先使用update方法而非put方法。update方法具有以下特点：

• 只会修改指定的字段
• 保留未修改字段的原始值
• 自动更新modified时间戳
• 保持created时间戳不变

时间戳管理的最佳实践

1. 创建新实体：使用put方法，此时created和modified会被设置为相同值
2. 更新已有实体：使用update方法，仅更新modified时间戳
3. 完全替换实体：使用put方法，但需注意这会重置created时间戳

底层原理

DynamoDB-Toolbox的时间戳管理是通过实体定义中的timestamps配置实现的。默认情况下，它会自动管理created和modified两个字段。当使用put时，工具无法区分这是新实体创建还是旧实体替换，因此会统一处理这两个时间戳。

解决方案

如果业务上需要保持created时间戳不变，可以采用以下任一方案：

1. 在更新操作时显式指定原始的created值
2. 使用update方法而非put方法进行更新
3. 自定义实体配置，禁用自动时间戳管理，改为手动控制

理解这些行为差异有助于开发者更合理地设计数据访问模式，确保时间戳等关键字段符合业务预期。