在 DynamoDB 中,对同一主键(partition key)多次调用 put_item 会完全覆盖整条记录,而非合并字段;若需增量添加或更新属性,应改用 update_item 并配合 SET 操作。
在 dynamodb 中,对同一主键(partition key)多次调用 `put_item` 会完全覆盖整条记录,而非合并字段;若需增量添加或更新属性,应改用 `update_item` 并配合 `set` 操作。
当你在循环中对同一个分区键(如 "pk": "787")反复调用 table.put_item(),每次调用都会写入一条全新的完整项(item)——即 DynamoDB 会用新传入的字典完全替换该主键下已存在的整条记录。因此,第一轮写入 {"pk": "787", "orderId": "569782152"} 后,第二轮 {"pk": "787", "incBaseFx": "1.0"} 会直接抹掉 orderId 字段,最终仅保留后者。
✅ 正确做法:使用 update_item 实现字段级增量更新:
record_data = "orderId:569782152,incBaseFx:1.0"
record_data_list = record_data.split(",")
# 构建 UpdateExpression 和 ExpressionAttributeNames/Values
update_expr_parts = []
expr_attr_names = {}
expr_attr_values = {}
for record_data_list_item in record_data_list:
x, y = record_data_list_item.split(":")
placeholder = f"#{x}"
value_placeholder = f":{x}"
update_expr_parts.append(f"{placeholder} = {value_placeholder}")
expr_attr_names[placeholder] = x
expr_attr_values[value_placeholder] = y
# 组装 UpdateItem 请求
table.update_item(
Key={"pk": "787"},
UpdateExpression=f"SET {' , '.join(update_expr_parts)}",
ExpressionAttributeNames=expr_attr_names,
ExpressionAttributeValues=expr_attr_values
)? 关键说明:
- update_item 的 SET 操作仅修改指定字段,其余属性保持不变;
- 使用 ExpressionAttributeNames 避免字段名含保留字或特殊字符时报错;
- 使用 ExpressionAttributeValues 安全注入值(防止类型/格式错误);
- 所有字段更新在单次原子操作中完成,避免竞态与中间状态丢失。
⚠️ 注意事项:
- put_item 适用于“创建或完全替换整条记录”,update_item 适用于“局部更新”;
- 若记录不存在,update_item 会自动创建(前提是主键完整),但不会覆盖其他未指定字段;
- 多字段批量更新务必统一构建表达式,避免多次 update_item 调用引发逻辑耦合或性能开销。
通过上述方式,最终 DynamoDB 中将正确存储:{"pk": "787", "orderId": "569782152", "incBaseFx": "1.0"} —— 实现预期的多属性共存。

















