DynamoDB如何仅在条目存在时更新 解决参数混用ValidationException报错

• 抛出ValidationException的直接原因是DynamoDBUpdateItem接口不允许同时混用两类参数：旧版遗留的非表达式参数AttributeUpdates，和新版的表达式类参数（包括UpdateExpression、ExpressionAttributeNames等），两类参数只能二选一。目前AWS官方推荐统一使用表达式语法，AttributeUpdates已经不再维护。
• 原代码存在额外参数误用：ExpressionAttributeNames仅用于映射#开头的属性名占位符，:serial这类值占位符需要定义在ExpressionAttributeValues参数中。
• 默认情况下UpdateItem是Upsert逻辑：条目存在则更新，不存在则自动新建。要实现「仅更新存在的条目、不存在则不新建」，需要通过条件表达式限制执行前提。

import boto3
from botocore.exceptions import ClientError

dynamodb = boto3.client('dynamodb')
element = 'test'

try:
    resp = dynamodb.update_item(
        TableName='myTable',
        Key={
            'serial': {'S': element}
        },
        # 定义更新逻辑：将total字段设为数值0
        UpdateExpression='SET #total = :total_val',
        # 执行前提：主键serial存在（即目标条目已存在）
        ConditionExpression='attribute_exists(#serial)',
        # 属性名占位符映射，规避DynamoDB保留字冲突
        ExpressionAttributeNames={
            '#total': 'total',
            '#serial': 'serial'
        },
        # 属性值占位符映射
        ExpressionAttributeValues={
            ':total_val': {'N': '0'}
        }
    )
    print("更新完成", resp)
except ClientError as e:
    if e.response['Error']['Code'] == 'ConditionalCheckFailedException':
        # 条件不满足，说明条目不存在，不会新建也不会更新
        print("目标条目不存在，跳过操作")
    else:
        # 其余错误正常抛出
        raise

• 完全移除了旧版AttributeUpdates参数，所有更新逻辑通过UpdateExpression实现，彻底解决参数混用的校验报错问题。
• ConditionExpression='attribute_exists(#serial)'是实现「不存在不新建」的核心：DynamoDB执行更新前会先校验条件，只有分区键serial存在（即条目真实存在）时才会执行更新；如果条目不存在，条件校验直接失败，不会触发新建逻辑，只会抛出ConditionalCheckFailedException，捕获该异常即可处理条目不存在的场景。
• 修正了原代码的逻辑错误：主键serial是条目的唯一标识，无法通过UpdateItem修改，原代码中尝试给serial赋值的写法本身不符合DynamoDB规则，修正后仅更新业务字段total。
• 明确区分了两类占位符的使用规则：#前缀为属性名占位符，配置在ExpressionAttributeNames中；:前缀为属性值占位符，配置在ExpressionAttributeValues中。

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