为何DynamoDB.update()无法更新user_subscription表中的字段？

问题场景 #

我有一个名为user_subscription的DynamoDB表，想要将status字段从"ACTIVE"更新为"INACTIVE"，使用的代码如下：

const params = {
  TableName: "user_subscription",
  Key: {
    userId: userId,
    subscription_id: "abc",
  },
  updateExpression: "SET status = :newStatus",
  expressionAttributeValues: { ":newStatus": "INACTIVE" },
  ReturnValues: "ALL_NEW",
};
console.log("params", params);
try {
  dynamoDb.update(params, (error, data) => {
    console.log("error", error, "data", data);
  });
} catch (err) {}

执行后发现status字段并未更新，返回的响应数据中status仍为"ACTIVE"：

Attributes: {
  plan_id: 'dkdkkd',
  subscription_id: 'abc',
  userId: 'ebef4c92-9fa8-4e1b-878f-d5753bb4042a',
  updatedAt: '2022-12-25T08:18:32.681Z',
  status: 'ACTIVE',
  createdAt: '2022-12-25T08:18:32.681Z'
}

可能原因及解决方案 #

1. 异步错误捕获失效 #

原代码用回调函数调用dynamoDb.update，外层的try/catch无法捕获回调内部的错误——回调是异步执行的，错误不会冒泡到外层同步代码块，导致更新出错时无法看到错误信息，难以排查问题。

修复方案：改用Promise+async/await写法，让错误能被try/catch正确捕获：

const updateSubscriptionStatus = async () => {
  const params = {
    TableName: "user_subscription",
    Key: {
      userId: userId,
      subscription_id: "abc",
    },
    UpdateExpression: "SET status = :newStatus",
    ExpressionAttributeValues: { ":newStatus": "INACTIVE" },
    ReturnValues: "ALL_NEW",
  };

  try {
    const data = await dynamoDb.update(params).promise();
    console.log("更新成功，返回数据:", data);
  } catch (err) {
    console.error("更新失败，错误信息:", err);
  }
};

updateSubscriptionStatus();

2. 主键值不匹配 #

确认userId变量的实际值是否与表中记录的userId完全一致，包括大小写、UUID格式（连字符位置）、是否存在空格等。如果主键不匹配，DynamoDB找不到对应记录，自然不会更新任何字段。

排查方式：打印userId的实际值，和返回数据中的userId（ebef4c92-9fa8-4e1b-878f-d5753bb4042a）对比，确保完全一致。

3. 可选：添加条件表达式确保更新逻辑精准 #

如果需要仅当当前status为"ACTIVE"时才执行更新，可以添加条件表达式，避免误覆盖其他状态，同时能在条件不满足时抛出明确错误：

// 在params中添加以下配置
ConditionExpression: "status = :oldStatus",
ExpressionAttributeValues: { 
  ":newStatus": "INACTIVE",
  ":oldStatus": "ACTIVE"
}

如果当前记录的status不是"ACTIVE"，会抛出ConditionalCheckFailedException，便于快速定位问题。

4. 客户端配置验证 #

检查DynamoDB客户端是否配置了正确的区域，是否连接到了目标表所在的环境（比如测试环境和生产环境混淆）。

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