如何在PutItemRequest中实现DynamoDB GSI的唯一性约束？

你的问题出在对DynamoDB条件表达式的理解上：

• attribute_not_exists函数是针对当前要插入的项对应的主键记录进行检查的，它只会判断这个主键对应的项里是否不存在指定属性，不会检查整个表（或GSI）中是否有其他项包含相同的MAC/注册码值。
• 由于你插入的新项和已存在的项主键不同，条件表达式会判定为满足，因此插入成功。另外，GSI只是辅助索引，条件表达式无法直接基于GSI的全局值做唯一性校验。

正确实现全局唯一性约束的方法 #

方法1：将唯一字段设为主键 #

如果MAC_ADDRESS（或REGISTRATION_CODE）适合作为表的分区键，直接把它设为表的分区键。DynamoDB主键天然具备唯一性，重复插入相同分区键的项会直接报错（除非覆盖已有项），以此保证全局唯一性。

方法2：创建带唯一约束的GSI #

创建GSI时开启唯一约束（设置IsUnique为true），这样当插入的项在GSI键上存在重复值时，DynamoDB会直接拒绝写入请求。注意：唯一约束只能在创建GSI时设置，已存在的GSI无法修改该属性。

方法3：用辅助表做唯一性校验 #

创建一个专门的唯一性校验表（比如UniqueMACs），将MAC_ADDRESS作为该表的分区键。插入主表前执行以下操作：

1. 向UniqueMACs表执行PutItem操作，条件表达式设为attribute_not_exists(#mac)
2. 如果PutItem成功，再插入主表；如果抛出ConditionalCheckFailedException，说明MAC已存在，终止主表插入

这种方法利用主键唯一性实现全局校验，还可通过DynamoDB事务把两个操作绑定，保证原子性。

修正后的代码示例（以辅助表校验MAC为例） #

// 先校验MAC唯一性
var checkMacReq = PutItemRequest.builder()
        .tableName("UniqueMACs")
        .item(Map.of(MAC_ADDRESS, AttributeValue.builder().s(newMacValue).build()))
        .conditionExpression("attribute_not_exists(#mac)")
        .expressionAttributeNames(Map.of("#mac", MAC_ADDRESS))
        .build();

try {
    dynamoDbClient.putItem(checkMacReq);
    // 校验通过，插入主表
    var mainReq = PutItemRequest.builder()
            .tableName(TABLE_NAME)
            .item(getAllValues(settings))
            .build();
    dynamoDbClient.putItem(mainReq);
} catch (ConditionalCheckFailedException e) {
    // MAC已存在，处理重复逻辑
    System.out.println("MAC地址已存在，无法插入");
}

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