含冒号的DynamoDB主键执行条件PutItem报错，求解决方案

问题原因 #

DynamoDB的ConditionExpression语法里，冒号:是标记表达式属性值的占位符，直接把带冒号的主键值（比如abc:123）写入表达式时，会被解析器误判为语法的一部分，从而触发语法错误。

解决方法 #

使用**表达式属性值（ExpressionAttributeValues）**传递带特殊字符的主键值，同时在ConditionExpression里用占位符替代具体值，彻底规避冒号的语法冲突。

示例代码（以Python Boto3为例） #

import boto3

dynamodb = boto3.resource('dynamodb')
table = dynamodb.Table('你的表名')

response = table.put_item(
    Item={
        'PartitionKey': 'abc:def',
        'SortKey': 'abc:123',
        # 此处添加其他需要插入的属性
    },
    ConditionExpression='attribute_not_exists(#pk) AND attribute_not_exists(#sk)',
    ExpressionAttributeNames={
        '#pk': 'PartitionKey',
        '#sk': 'SortKey'
    },
    ExpressionAttributeValues={
        ':pk_val': 'abc:def',
        ':sk_val': 'abc:123'
    }
)

关键说明 #

• ExpressionAttributeNames：用占位符替代属性名（即使主键名无特殊字符，也推荐用这种方式，避免潜在冲突）
• ExpressionAttributeValues：将带冒号的主键值放在这里，通过:pk_val、:sk_val这类占位符在ConditionExpression中引用，让冒号仅作为值的一部分存在
• 条件逻辑：当指定的主键组合已存在时，对应的属性必然存在，attribute_not_exists条件不满足，PutItem操作会自动终止，不会插入新条目

额外建议 #

不管主键值是否包含特殊字符，都推荐使用表达式属性值和属性名的方式构建条件表达式，这是DynamoDB的官方最佳实践，能避免各类语法冲突问题。

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