DynamoDB：CLI执行ADD操作正常，TypeScript报Invalid UpdateExpression错误

使用AWS CLI执行DynamoDB的ADD操作递增属性值时可以正常工作：

aws dynamodb update-item --table-name my-table \
    --key '{"id": {"S": "12356"}}' \
    --update-expression "ADD myattribute :val" \
    --expression-attribute-values '{":val": {"N": "1"}}'

但用TypeScript的AWS SDK实现等效逻辑时，却触发错误：

public async increment(id: string): Promise<void> {
  await this.db.update({
    TableName: this.tableName,
    Key: {
      "id": { S: id },
    },
    ExpressionAttributeValues: {
      ":val": { N: "1" }
    },
    UpdateExpression: "ADD myattribute :val"
  }).promise()
}

错误信息：

ValidationException: Invalid UpdateExpression: Incorrect operand type for operator or function; operator: ADD, operand type: MAP, typeSet: ALLOWED_FOR_ADD_OPERAND

原因与解决方法 #

问题根源 #

你的代码中this.db大概率是AWS.DynamoDB.DocumentClient实例，而非原始的AWS.DynamoDB客户端。两者参数格式规则完全不同：

• 原始AWS.DynamoDB客户端需要显式指定类型标记（如{S: "xxx"}、{N: "1"}），和CLI命令的格式完全匹配；
• DocumentClient是高层封装，会自动处理数据类型转换，无需手动添加类型标记，直接传入原始值即可。

你用DocumentClient却传入了原始客户端的参数格式，导致{N: "1"}被识别为一个MAP类型的嵌套对象，而ADD操作仅支持数值或集合类型作为操作数，因此触发类型错误。

解决方案 #

分两种场景处理：

场景1：继续使用DocumentClient

修改参数格式，移除类型标记，直接传入原始值：

public async increment(id: string): Promise<void> {
  await this.db.update({
    TableName: this.tableName,
    Key: { id }, // 直接传入字符串ID
    ExpressionAttributeValues: { ":val": 1 }, // 直接传入数字
    UpdateExpression: "ADD myattribute :val"
  }).promise()
}

场景2：改用原始AWS.DynamoDB客户端

如果坚持使用显式类型标记的格式，需确保this.db是AWS.DynamoDB的实例（而非DocumentClient）。此时你原有代码的格式是正确的，检查客户端初始化代码即可，例如：

import AWS from 'aws-sdk';
const db = new AWS.DynamoDB(); // 而非new AWS.DynamoDB.DocumentClient()

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