DynamoDB：如何对可能不存在的记录设置嵌套值

错误原因 #

你遇到的ValidationException是因为UpdateExpression中同时操作了两个重叠的路径：#attachments（整个对象）和#attachments.#attachmentId（对象的子属性）。DynamoDB不允许同时修改父路径和子路径，因为修改父路径会覆盖整个对象，后续的子路径操作会失去意义。

正确实现方式 #

可以通过合并Map的方式在单次UpdateCommand中完成upsert，既保证attachments字段存在，又能更新指定的子属性，同时避免路径冲突：

核心UpdateExpression

SET #attachments = if_not_exists(#attachments, :emptyMap) + :attachmentEntry

参数说明

• if_not_exists(#attachments, :emptyMap)：确保attachments字段存在，若原条目无该字段，则初始化为空Map；若已有该字段，则保留原Map。
• + :attachmentEntry：将包含目标attachmentId和对应记录的Map合并到attachments中，自动覆盖已存在的同键值，同时保留其他已有的子属性。

完整代码示例（AWS SDK v3）

const { UpdateCommand } = require("@aws-sdk/lib-dynamodb");

const updateCommand = new UpdateCommand({
  TableName: "你的表名",
  Key: {
    // 替换为你的主键，例如：id: "目标条目ID"
  },
  UpdateExpression: "SET #attachments = if_not_exists(#attachments, :emptyMap) + :attachmentEntry",
  ExpressionAttributeNames: {
    "#attachments": "attachments"
  },
  ExpressionAttributeValues: {
    ":emptyMap": {},
    ":attachmentEntry": {
      "替换为你的attachmentId": { /* 替换为你的attachmentRecord内容 */ }
    }
  },
  // 可选：返回更新后的完整条目
  ReturnValues: "ALL_NEW"
});

// 执行命令（需结合你的DynamoDB客户端）
// const result = await dynamoDbClient.send(updateCommand);

效果说明 #

• 若目标条目不存在：自动创建条目，attachments字段初始化为包含指定attachmentId的Map。
• 若目标条目已存在但无attachments字段：自动创建attachments字段并写入指定的attachment记录。
• 若目标条目已存在且有attachments字段：更新指定attachmentId对应的记录，保留其他已存在的attachment。

内容的提问来源于stack exchange，提问作者Daniel Birowsky Popeski