如何将Mongoose邮箱唯一性验证错误包装进ValidationError并在表单展示？

我来帮你搞定这个问题！其实你已经走对了方向——mongoose-unique-validator插件本来就是用来把MongoDB的唯一索引冲突错误包装成Mongoose的ValidationError的，你只需要在代码里正确捕获这个错误，然后把错误信息传递到表单页面展示就可以了。

第一步：在保存/验证时正确捕获ValidationError #

不管你是用回调还是async/await，都要在处理用户保存的逻辑里捕获错误，然后提取对应字段的错误信息。比如用async/await的写法：

// 示例：用户注册的路由处理
app.post('/register', async (req, res) => {
  try {
    // 创建新用户实例
    const newUser = new User(req.body);
    // 保存到数据库
    await newUser.save();
    // 保存成功后的逻辑，比如跳转登录页
    res.redirect('/login');
  } catch (err) {
    // 重点：判断是否是ValidationError
    if (err.name === 'ValidationError') {
      // 把错误信息整理成键值对，方便前端模板使用
      const formErrors = {};
      Object.keys(err.errors).forEach(field => {
        formErrors[field] = err.errors[field].message;
      });
      // 把错误和用户之前输入的内容传回表单页面
      return res.render('register', { errors: formErrors, inputData: req.body });
    }
    // 处理其他非验证类错误（比如数据库连接问题）
    res.status(500).send('服务器出现异常，请稍后重试');
  }
});

第二步：在表单页面展示错误信息 #

假设你用的是EJS这类模板引擎，在表单页面里针对邮箱字段添加错误提示：

<form action="/register" method="POST">
  <div class="form-group">
    <label for="email">邮箱</label>
    <input 
      type="email" 
      id="email" 
      name="email" 
      value="<%= inputData ? inputData.email : '' %>"
    >
    <!-- 如果存在邮箱的错误，就显示出来 -->
    <% if (errors && errors.email) { %>
      <p class="error-text" style="color: red;">
        <%= errors.email %>
      </p>
    <% } %>
  </div>

  <!-- 用户名、密码字段同理 -->
  <div class="form-group">
    <label for="username">用户名</label>
    <input 
      type="text" 
      id="username" 
      name="username" 
      value="<%= inputData ? inputData.username : '' %>"
    >
    <% if (errors && errors.username) { %>
      <p class="error-text" style="color: red;">
        <%= errors.username %>
      </p>
    <% } %>
  </div>

  <button type="submit">注册</button>
</form>

可选：自定义错误提示文本 #

如果你觉得默认的错误提示不够友好，可以在注册插件的时候自定义提示语：

UserSchema.plugin(uniqueValidator, {
  message: '{PATH} 已经被注册，请更换其他邮箱尝试'
});

这里的{PATH}会自动替换成字段名（比如email），最终错误信息就会变成“email 已经被注册，请更换其他邮箱尝试”，更符合中文用户的习惯。

原理说明 #

mongoose-unique-validator的核心作用就是把MongoDB原生的唯一索引冲突错误（原本是MongoError类型）转化为Mongoose标准的ValidationError，这样你就可以把唯一性错误和其他字段的验证错误（比如必填项为空）统一处理，不用单独写逻辑区分两种错误类型。

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