ValidationException: Invalid UpdateExpression

TL;DR — 你的 UpdateExpression 格式错误。十有八九是一个保留字（如 status、name、size）被直接使用了——把它换成 ExpressionAttributeNames 中的一个 #placeholder。消息会指明确切的标记。

含义

典型消息：

ValidationException: Invalid UpdateExpression: Attribute name is a reserved keyword; reserved keyword: status
ValidationException: Invalid UpdateExpression: Syntax error; token: "=", near: "SET status ="
ValidationException: Invalid UpdateExpression: An expression attribute value used in expression is not defined; attribute value: :s

DynamoDB 解析表达式字符串，并拒绝任何不是有效语法或引用了未定义占位符的东西。

为什么会发生

直接使用了保留字。 DynamoDB 有数百个保留字——status、name、size、count、data、year。在表达式中直接使用它们会导致语法错误。保留字检查器会对照完整列表测试你的属性名，并输出别名映射。
缺少你引用的 #name 的 ExpressionAttributeNames 条目。
缺少你引用的 :value 的 ExpressionAttributeValues 条目。
动词语法错误——错误地混用子句（SET、REMOVE、ADD、DELETE 各有其自己的语法），或一个多余的 =。
含特殊字符的属性名（点、横线）在没有占位符的情况下被使用。

如何修复

通过 ExpressionAttributeNames 为每个属性名起别名（#status）——它完全绕开了保留字列表，因此给所有名称都起别名是一个安全的习惯。
在 ExpressionAttributeValues 中定义你引用的每个 :value。
使用正确的子句。 SET 用于写入/覆盖，REMOVE 用于删除一个属性，ADD 用于原子的数字/集合自增，DELETE 用于从集合中移除。

示例

import {DynamoDBClient} from '@aws-sdk/client-dynamodb';
import {DynamoDBDocumentClient, UpdateCommand} from '@aws-sdk/lib-dynamodb';

const doc = DynamoDBDocumentClient.from(new DynamoDBClient({}));

await doc.send(
  new UpdateCommand({
    TableName: 'Orders',
    Key: {pk: 'ORDER#1'},
    // #status aliases the reserved word "status"
    UpdateExpression: 'SET #status = :s, updatedAt = :t',
    ExpressionAttributeNames: {'#status': 'status'},
    ExpressionAttributeValues: {':s': 'SHIPPED', ':t': Date.now()}
  })
);

先在 DynoTable 中检查

当你的应用程序更新失败时，请在更改生产代码之前在 DynoTable 中重现它。使用 ⌘K 打开表，选择该项目，然后使用内联更新编辑器 — DynoTable 自动为保留属性名称添加别名，并显示生成的 UpdateExpression 和两个属性映射。暂存 (⌘S) 允许你在提交之前预览编辑并捕获语法错误。对于批量修复，请将失败的表达式粘贴到 Expression Builder 中，并将其输出与 SDK 发送的内容进行比较。 Profile 切换 (⌘P) 使测试在与错误相同的帐户上运行；使用“设置”→“配置文件”上的“测试连接”来确认配置文件匹配。有关配置文件设置，请参阅连接 AWS和安装。当错误命名特定标记（例如 status 或 data）时，交叉检查 reserved words checker 中的属性名称。对每个属性名称（而不仅仅是保留的属性名称）使用别名是一种安全的习惯，可以完全防止此类错误。

来源

Using update expressions in DynamoDB（2026-07-13 验证）
Reserved words in DynamoDB（2026-07-13 验证）

参考资料

最后核实于 2026-07-13，依据上方链接的 AWS 官方文档。