如何在DynamoDB中更新嵌套字段（父字段可能不存在）

我有多个需更新的DynamoDB条目，结构如下：

{
  "PK": "THING",
  "SK": "ZERO"
}

{
  "PK": "THING",
  "SK": "ONE",
  "one": { }
}

{
  "PK": "THING",
  "SK": "TWO",
  "one": { 
    "two": {}
  }
}

{
  "PK": "THING",
  "SK": "THREE",
  "one": {
    "two": {
      "three": {
        "a": "hello",
        "b": "goodbye"
      }
    }
  }
}

需要将所有条目中的one.two.three.a统一更新为"world"。部分条目可能不存在one字段，或存在one但缺失one.two，或存在one.two但缺失one.two.three，无法保证目标字段更新前已存在。需处理数千条此类条目，希望采用高效方案，无需事务，可逐条更新。

尝试过的方案及报错 #

方案一 #

const UpdateExpression = "SET #one = if_not_exists(#one, :one), #one.#two = if_not_exists(#one.#two, :two), #one.#two.#three = if_not_exists(#one.#two.#three, :three), #one.#two.#three.#a = :a"

const ExpressionAttributeNames = {
  "#one": "one",
  "#two": "two",
  "#three": "three",
  "#a": "a"
}

const ExpressionAttributeValues = {
  ":one": {
    "two": {
      "three": {
        "a": "world"
      }
    }
  },
  ":two": {
    "three": {
      "a": "world"
    }
  },
  ":three": {
    "a": "world"
  },
  ":a": "world"
}

报错信息：Invalid UpdateExpression: Two document paths overlap with each other; must remove or rewrite one of these paths

方案二 #

const UpdateExpression = "SET #one.#two.#three.#a = :a";

const ExpressionAttributeNames = {
  "#one": "one",
  "#two": "two",
  "#three": "three",
  "#a": "a"
}

const ExpressionAttributeValues = {
  ":a": "world"
}

报错信息：The document path provided in the update expression is invalid for update

部分相关方案建议捕获更新失败后补全缺失字段，但该方法仅适用于单一父字段缺失场景，不适用于多层缺失情况。

可行解决方案（TypeScript示例） #

核心思路：通过if_not_exists逐层确保每个父级字段存在（为空对象），再设置目标字段的值，既避免路径重叠，又解决父字段缺失的问题。

import { DynamoDBClient, UpdateItemCommand } from "@aws-sdk/client-dynamodb";
import { marshall, unmarshall } from "@aws-sdk/util-dynamodb";

// 初始化DynamoDB客户端
const dynamoClient = new DynamoDBClient({ region: "your-region" });

/**
 * 更新指定PK/SK条目中的one.two.three.a字段
 * @param pk 分区键值
 * @param sk 排序键值
 */
async function updateNestedField(pk: string, sk: string): Promise<void> {
  const updateParams = {
    TableName: "your-table-name", // 替换为你的表名
    Key: marshall({ PK: pk, SK: sk }),
    UpdateExpression: `
      SET #one = if_not_exists(#one, :emptyObj),
          #one.#two = if_not_exists(#one.#two, :emptyObj),
          #one.#two.#three = if_not_exists(#one.#two.#three, :emptyObj),
          #one.#two.#three.#a = :targetValue
    `,
    ExpressionAttributeNames: {
      "#one": "one",
      "#two": "two",
      "#three": "three",
      "#a": "a"
    },
    ExpressionAttributeValues: marshall({
      ":emptyObj": {},
      ":targetValue": "world"
    }),
    ReturnValues: "UPDATED_NEW" // 可选，返回更新后的字段内容
  };

  try {
    const response = await dynamoClient.send(new UpdateItemCommand(updateParams));
    console.log(`条目[PK:${pk}, SK:${sk}]更新成功`, unmarshall(response.Attributes || {}));
  } catch (err) {
    console.error(`条目[PK:${pk}, SK:${sk}]更新失败`, err);
    throw err;
  }
}

// 使用示例：遍历需要更新的条目列表调用
// const itemsToUpdate = [
//   { PK: "THING", SK: "ZERO" },
//   { PK: "THING", SK: "ONE" },
//   { PK: "THING", SK: "TWO" },
//   { PK: "THING", SK: "THREE" }
// ];
// await Promise.all(itemsToUpdate.map(item => updateNestedField(item.PK, item.SK)));

方案说明 #

1. 逐层确保父字段存在：通过if_not_exists(#one, :emptyObj)判断，若one字段不存在则创建空对象；同理处理one.two和one.two.three，确保所有父层级都存在。
2. 避免路径重叠：仅为空对象创建父字段，而非直接设置完整嵌套结构，不会和子字段的更新路径产生冲突。
3. 保留原有数据：已存在的父字段不会被覆盖，比如原本one.two.three有b字段，更新后b字段仍保留，仅修改a字段的值。

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