为何获取DynamoDB记录修改主键后Put回表会覆盖原记录？

现有认知校验 #

你的4条认知大部分是准确的，仅小部分需要补充修正：

• 第1点认知基本正确，补充说明：PutItem的覆盖是原子性的单步操作，并非先删除旧记录再写入新记录的两步操作，但最终表现为旧记录整体被新传入的Item替换，效果和你理解的一致。
• 第2点认知完全正确。DynamoDB仅以*主键（分区键+可选排序键）*作为Item的唯一标识，只要传入Item的主键与已有Item主键完全匹配，就会直接覆盖整条记录，你举的{ primaryKey: "hey", otherAttribute: "yo" }覆盖{ primaryKey: "hey", otherAttribute: "sup" }的示例符合实际逻辑。
• 第3点认知完全正确。非主键属性没有全局唯一性约束，同一张表内允许多个Item的非主键属性完全重复。
• 第4点认知逻辑上成立。只要修改后的主键是全局唯一且和原记录主键完全不同，PutItem操作只会新增一条Item，不会对原记录产生任何影响。DynamoDB不存在任何跨主键的Item关联识别机制，不可能将主键不同的两个Item判定为同一条记录进行覆盖。

原记录消失的常见排查方向 #

你遇到的原记录消失问题和DynamoDB的核心机制无关，可按以下优先级排查：

• 检查代码逻辑是否误删原记录：确认修改主键写入新Item之后，有没有额外执行DeleteItem操作删除原记录，或者存在逻辑分支误触发了删除操作。
• 确认主键字段修改是否正确：高频出现的错误是主键字段名写错，比如实际主键字段为order_id，代码中误修改了orderId字段的值，实际写入时主键还是原记录的主键，自然会覆盖原记录。你可以打印写入前后Item的完整内容，确认主键字段的名称、值确实发生了变化。
• 核查表的TTL配置：如果你的表开启了TTL（生存时间）自动删除功能，可能刚好原记录的TTL过期时间和你写入新记录的时间重合，DynamoDB后台自动删除了原记录，和PutItem操作无关，你可以在表的控制台查看TTL配置，以及原记录的TTL属性值是否刚好过期。
• 排查其他操作来源：确认是否有其他Lambda、定时任务、人工操作在同一时间窗口操作了该原记录，主动删除或修改了原记录的主键。
• 检查是否使用了事务写：如果你的代码用了DynamoDB事务，确认事务中是否同时包含了删除原记录、写入新记录的操作，导致原记录被同步删除。

快速验证方案 #

你可以临时修改Lambda逻辑，仅做日志打印不执行写入操作：打印读取到的原记录完整内容、修改后待写入的Item完整内容，对比两者的主键是否确实不同；同时在DynamoDB控制台的指标页签下查看DeleteItem、TTLDeletes的指标变化，确认删除操作的来源。

内容的提问来源于stack exchange，提问作者David Maness