MongoDB聚合批量小写用户名误删文档及唯一索引冲突问题

$out 阶段的固有行为就是：如果写入的目标集合已存在，会全量替换整个集合的所有数据，仅保留聚合管道最终输出的文档。
你的管道第一阶段就通过$match过滤掉了所有username已经是全小写的文档，这些文档根本不会进入后续管道、也不会出现在最终输出结果里，执行$out之后原集合被整个替换，自然就只剩你处理过的非全小写文档，原本全小写的文档全部被删除了。

另外你当前的逻辑也没做重复值校验，只要出现大小写重名（比如同时存了Alice和alice两个账号），转小写后就会触发唯一索引冲突，直接中断执行。

不要用$out做全量覆盖，改用支持增量更新的$merge阶段写入原集合，同时增加冲突检测逻辑跳过重名文档，完整代码如下：

await userLogin.aggregate([
  // 筛选出username包含大写、待处理的文档
  {
    '$match': {
      '$expr': {
        '$ne': [
          '$username', { '$toLower': '$username' }
        ]
      }
    }
  },
  // 临时存储转小写后的目标username值
  {
    '$set': {
      'targetLowerName': { '$toLower': '$username' }
    }
  },
  // 自连接检查目标小写用户名是否已经存在
  {
    '$lookup': {
      'from': 'userLogin',
      'localField': 'targetLowerName',
      'foreignField': 'username',
      'as': 'duplicateUsers'
    }
  },
  // 过滤掉存在重名冲突的文档，避免触发唯一索引报错
  {
    '$match': {
      'duplicateUsers': { '$size': 0 }
    }
  },
  // 正式更新username为小写值，清理临时字段
  {
    '$set': {
      'username': '$targetLowerName'
    }
  },
  {
    '$unset': ['targetLowerName', 'duplicateUsers']
  },
  // 增量写入原集合，仅替换匹配到的待处理文档，不影响原有全小写的正常文档
  {
    '$merge': {
      'into': 'userLogin',
      'on': '_id',
      'whenMatched': 'replace',
      'whenNotMatched': 'discard'
    }
  }
]);

注意事项 #

• 执行操作前先对userLogin集合做一次完整备份，避免误操作丢数据，50万文档的备份耗时很短
• 上述逻辑会自动跳过存在大小写重名的冲突文档，这类文档不会被修改，你可以后续单独拉取冲突列表做人工处理
• 如果你的MongoDB版本低于4.2不支持$merge，不要直接用聚合写原集合，先把处理后的无冲突结果输出到临时集合，核对数据无误后再手动做增量合并，绝对不要直接用$out覆盖生产集合。

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