Mongoose如何校验用户名与邮箱唯一性并返回对应错误提示

原代码问题说明 #

你当前写的const userExists = await User.findOne({ credentials });逻辑存在缺陷：该查询只会匹配同时和传入的邮箱、用户名、密码完全一致的用户，无法识别仅邮箱重复或仅用户名重复的场景，因此插入时会触发MongoDB的唯一键冲突错误。

方案一：预查询校验（可同时返回多个重复错误，推荐） #

使用MongoDB的$or操作符单次查询出所有邮箱或用户名重复的用户，再分别判断两个字段的重复情况，支持同时返回两个字段都重复的错误，前端可一次性展示所有问题。
修改控制器中的校验逻辑如下：

const registerUser = asyncHandler(async (req, res) => {
  const {
    profile,
    credentials,
    hiddenChannel,
    origin_server,
    channelImage,
    organization,
  } = req.body;
  const { email, username } = credentials;

  // 单次查询匹配所有邮箱/用户名重复的用户
  const duplicateRecords = await User.find({
    $or: [
      { "credentials.email": email },
      { "credentials.username": username }
    ]
  });

  const errorList = [];
  // 判断邮箱是否重复
  if (duplicateRecords.some(item => item.credentials.email === email)) {
    errorList.push({
      code: "EMAIL_DUPLICATE",
      msg: "该邮箱已被注册"
    })
  }
  // 判断用户名是否重复
  if (duplicateRecords.some(item => item.credentials.username === username)) {
    errorList.push({
      code: "USERNAME_DUPLICATE",
      msg: "该用户名已被占用"
    })
  }

  // 存在重复错误直接返回
  if (errorList.length > 0) {
    res.status(400);
    // 可根据自己的错误处理规则返回，这里直接抛结构化错误即可
    throw new Error(JSON.stringify(errorList));
  }

  // 后续原有创建用户逻辑不变
  const user = await User.create({
    profile,
    credentials,
    channelImage: channelImage === undefined ? "" : channelImage,
    organization,
    origin_server,
    hiddenChannel,
  });

  if (user) {
    res.status(201).json({
      _id: user._id,
      name: user.name,
      email: user.email,
      isAdmin: user.isAdmin,
      token: generateToken(user._id),
    });
  } else {
    res.status(400);
    throw new Error("Invalid user data");
  }
});

方案二：捕获MongoDB唯一键冲突错误（性能更高） #

MongoDB插入时遇到唯一键冲突会抛出错误码为11000的异常，错误对象中的keyPattern字段会标记是哪个字段触发的唯一约束，你可以在全局错误处理中间件中解析该错误返回对应提示。
全局错误处理中间件示例：

// Express全局错误处理中间件，需要放在所有路由之后
app.use((err, req, res, next) => {
  const status = res.statusCode === 200 ? 500 : res.statusCode;
  res.status(status);

  // 处理唯一键重复错误
  if (err.code === 11000) {
    const duplicateKey = Object.keys(err.keyPattern)[0];
    if (duplicateKey === "credentials.email") {
      return res.send({
        code: "EMAIL_DUPLICATE",
        msg: "该邮箱已被注册"
      })
    }
    if (duplicateKey === "credentials.username") {
      return res.send({
        code: "USERNAME_DUPLICATE",
        msg: "该用户名已被占用"
      })
    }
  }

  // 其他错误处理逻辑
  res.send({
    msg: err.message,
    stack: process.env.NODE_ENV === "production" ? null : err.stack
  })
})

该方案无需额外查询数据库，性能更好，但缺点是单次插入仅能返回第一个触发的重复错误，无法同时提示邮箱和用户名都重复的情况。

优化建议 #

• 可在Schema的邮箱字段配置中添加lowercase: true，自动将用户输入的邮箱转为小写，避免大小写不同的同一邮箱被判定为不同账号。
• 密码入库前一定要做哈希处理，不要存储明文密码。

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