DynamoDB的UpdateItemCommand是否支持仅更新模式以避免Upsert？

好问题！你完全可以通过给update()方法添加ConditionExpression来实现仅更新已存在的项，不需要额外的前置查询，还能彻底避免竞态条件的问题。

核心原理 #

DynamoDB的ConditionExpression会在执行更新操作之前原子性地检查指定条件，只有条件满足时才会执行更新；如果条件不满足（比如记录不存在），则会直接抛出ConditionalCheckFailedException异常，不会执行Upsert操作。

对于你的复合主键（id + siteId），只需要用attribute_exists()函数判断这两个主键属性是否存在即可——因为DynamoDB中主键属性必然存在于已创建的项中。

修改后的TypeScript代码 #

import { nativeDocumentClient, nativeDynamo } from '../utils/aws';

// 省略其他代码

// updatedProducts 的类型为 `{ id: string; siteId: string; state: ProductState }[]`

await Promise.all(
  updatedProducts.map(async ({ id, siteId, state }) => {
    try {
      await nativeDocumentClient
        .update({
          TableName,
          Key: {
            id,
            siteId,
          },
          ExpressionAttributeNames: {
            '#s': 'state',
          },
          ExpressionAttributeValues: {
            ':state': state,
            ':updatedAt': new Date().toISOString(),
          },
          UpdateExpression: 'SET #s = :state, updatedAt = :updatedAt',
          ReturnValues: 'ALL_NEW',
          // 关键：添加条件表达式，仅当复合主键对应的项存在时才执行更新
          ConditionExpression: 'attribute_exists(id) AND attribute_exists(siteId)'
        })
        .promise();
    } catch (error) {
      if (error.name === 'ConditionalCheckFailedException') {
        // 根据业务需求处理：比如记录日志，跳过不存在的项
        console.log(`Skipping update for product ${id} (site ${siteId}): item does not exist`);
      } else {
        // 重新抛出其他类型的异常，避免吞掉错误
        throw error;
      }
    }
  })
);

为什么这比前置查询更可靠？ #

你担心的前置查询+更新的方式确实存在竞态：比如在你查询到记录存在后，另一个操作可能在你执行更新前删除了这条记录，导致最终还是执行了Upsert。

而ConditionExpression是和更新操作原子性执行的——DynamoDB会在同一个事务里完成条件检查和更新操作，中间不会有其他操作干扰，完全消除了竞态风险。

补充说明 #

• 这种方式完全符合DynamoDB的设计规范，官方文档也明确推荐用条件表达式来控制操作的执行条件；
• 你不需要担心性能问题：条件检查的开销极低，和单次更新操作的成本几乎一致，远低于“查询+更新”两次操作的开销。

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