如何在MongoDB中避免用户自定义用户名并发提交时出现重复

解决方案 #

1. 数据库层面添加唯一索引（兜底方案，必须配置）

• 直接在用户集合的username字段创建全局唯一索引，执行语句：
  db.users.createIndex({username: 1}, {unique: true})
• 若需要实现类似Github的大小写不敏感规则（即U1和u1判定为重复），创建索引时增加排序规则配置：
  db.users.createIndex({username: 1}, {unique: true, collation: {locale: 'en', strength: 2}})
• 唯一索引是数据库层面的最后防线，无论上层逻辑是否存在并发漏洞，重复用户名写入时都会直接抛出DuplicateKey错误，从根本上禁止重复数据生成。

2. 业务逻辑层替换「先查后写」为原子操作（核心优化方案）

• 原有拆分查询、写入两个独立请求的逻辑天然存在时间差窗口，是并发冲突的核心原因，直接改用MongoDB原子更新方法findOneAndUpdate合并两个操作，示例逻辑如下：

const updateRes = await db.users.findOneAndUpdate(
  {
    _id: 当前验证用户的ID,
    username: { $exists: false } // 额外限制用户仅能设置一次用户名，避免重复提交
  },
  { $set: { username: 用户提交的用户名 } },
  { returnDocument: 'before' }
)

• 若返回结果存在且匹配到文档，说明用户名设置成功；若未匹配到文档，要么是目标用户名已被占用，要么是用户已经完成过用户名设置，直接返回对应错误即可。
• 原子操作在MongoDB层面是单线程串行执行的，完全消除了查询和写入之间的时间差漏洞。

3. 前端前置校验（体验优化方案）

• 用户在验证页输入用户名时，前端可实时发起查询请求校验用户名是否已被占用，提前给用户反馈，减少提交后才报错的情况。
• 该方案仅用于优化用户体验，不能替代前两个兜底方案，仍存在极短的并发冲突窗口。

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