DynamoDB PutItem ConditionExpression未判定为false致数据重复

你的ConditionExpression失效是对DynamoDB条件表达式的作用域理解错误导致的：

• DynamoDB中所有ConditionExpression仅对当前操作指向的单个精确主键（分区键+排序键组合）对应的条目生效，不会跨条目扫描、不会做全表级别的属性存在性校验。
• 你的表主键是email（分区键）+ 随机生成的id（排序键），每次写入时id都是全新的随机值，意味着每次PutItem操作指向的都是一个从未存在过的全新主键位置。对这个不存在的条目做attribute_not_exists(email) AND attribute_not_exists(firstName) AND attribute_not_exists(lastName)判断，结果永远为真——因为这个位置本来就没有任何条目，自然所有属性都不存在。
• 你期望的「全表检查有没有重复的email/firstName/lastName」逻辑，单靠普通PutItem的条件表达式根本不可能实现，这也是为什么重复值可以随意写入。

注意：很多新手误以为attribute_not_exists(非主键字段)会做全局去重，这是完全错误的认知，所有条件判断都不会跳出当前操作的单个主键条目范围。

你不需要修改现有「随机id作为排序键」的表设计，通过事务写入+唯一性占位条目的方案即可实现任意属性组合的全局唯一性校验，逻辑如下：

1. 针对你需要做唯一性约束的每一组属性，拼接成带固定前缀的字符串作为占位条目的分区键值，排序键用固定值（比如数字0），保证同一个唯一值对应的占位条目主键是固定不变的。
2. 用TransactWriteItems事务接口原子性执行两个操作：写入你原本的业务条目、写入对应的唯一性占位条目；给占位条目的写入加上attribute_not_exists(分区键)的条件判断。
3. 如果占位条目已经存在（说明之前已经写入过相同属性值的条目），条件校验会失败，整个事务会回滚，业务条目也不会写入，从根源避免重复。

参考实现代码 #

const dynamodb = new AWS.DynamoDB({apiVersion: '2012-08-10'})

// 原有业务参数
const randomId = "<someUniqueRandomNumber>"
const userEmail = "<email>"
const userFirstName = "<firstName>"
const userLastName = "<lastName>"

const params = {
  TransactItems: [
    // 1. 写入原有业务条目
    {
      Put: {
        TableName: "<table-name>",
        Item: {
          "email": { "S": userEmail },
          "id": { "N": randomId },
          "firstName": { "S": userFirstName },
          "lastName": { "S": userLastName }
        },
      }
    },
    // 2. email唯一性占位校验
    {
      Put: {
        TableName: "<table-name>",
        Item: {
          "email": { "S": `UNIQUE:EMAIL:${userEmail}` },
          "id": { "N": "0" }, // 固定排序键，保证同email的占位条目主键唯一
        },
        ConditionExpression: "attribute_not_exists(email)"
      }
    },
    // 3. 如果需要保障firstName+lastName组合全局唯一，放开下面这段注释即可
    // {
    //   Put: {
    //     TableName: "<table-name>",
    //     Item: {
    //       "email": { "S": `UNIQUE:FULLNAME:${userFirstName}:${userLastName}` },
    //       "id": { "N": "0" },
    //     },
    //     ConditionExpression: "attribute_not_exists(email)"
    //   }
    // }
  ]
}

dynamodb.transactWriteItems(params, function(err, data) {
  if (err) {
    if (err.code === 'TransactionCanceledException') {
      console.error("写入失败：存在重复属性值")
      return
    }
    console.error("写入异常", err)
  } else {
    console.log("写入成功")
  }
})

注意事项 #

• 不要用BatchWriteItems替代事务写入：批量写入不支持原子性，也不支持单条目的条件校验，会出现占位条目和业务条目写入不一致的问题。
• 占位条目的固定前缀建议和普通业务条目的分区键格式做明显区分，避免和正常业务数据主键冲突。
• 如果后续需要删除业务条目，记得在同一个事务里删掉对应的占位条目，否则后续相同值的写入会被永久拦截。

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