Mongoose异步请求Schema验证问题：邮箱唯一性校验函数报错

看起来你在给Mongoose Schema写邮箱唯一性验证时踩了版本兼容的坑——这个错误几乎都是因为你用了旧版Mongoose的回调式验证写法，但当前使用的Mongoose版本已经改用Promise来处理异步验证了。

错误原因拆解 #

早期Mongoose的路径验证器支持传入一个回调函数fn，用来异步返回验证结果，但在Mongoose 4.9+之后，异步验证器的规范变了：不再接收fn参数，而是要求验证函数返回一个Promise。你原来的代码里调用fn(!err && users.length === 0)，但这个fn参数已经不存在了，所以直接抛出了fn is not a function的错误。

修复后的验证代码 #

我们把验证逻辑改成Promise风格（用async/await更简洁），同时优化模型引用的方式，避免潜在的引用问题：

userSchema.path('email').validate(async function(email) {
  // 用this.constructor获取当前模型，比直接mongoose.model('User')更安全
  const User = this.constructor;
  
  // 只有新增文档，或者邮箱字段被修改时才执行唯一性校验
  if (this.isNew || this.isModified('email')) {
    const existingUsers = await User.find({ email }).exec();
    // 如果没有找到重复邮箱，返回true（验证通过）
    return existingUsers.length === 0;
  } else {
    // 邮箱没改动，直接通过验证
    return true;
  }
}, 'Email already exists');

抽成独立验证器（对应你提到的代码2片段） #

如果想把验证逻辑抽成单独的函数复用，可以这么写：

// 独立的唯一性验证函数
async function uniqueEmailValidator(email) {
  const User = this.constructor;
  if (this.isNew || this.isModified('email')) {
    const existingUsers = await User.find({ email }).exec();
    return existingUsers.length === 0;
  }
  return true;
}

// 在Schema中使用
const userSchema = new mongoose.Schema({
  email: {
    type: String,
    required: true,
    validate: [
      {
        validator: uniqueEmailValidator,
        message: 'Email already exists'
      }
    ]
  }
});

额外建议：双重保障唯一性 #

虽然自定义验证器能在应用层拦截重复邮箱，但并发场景下可能出现竞态问题（比如两个请求同时提交相同邮箱，验证器都通过了，但数据库会报错）。所以建议同时给email字段添加MongoDB唯一索引：

const userSchema = new mongoose.Schema({
  email: {
    type: String,
    required: true,
    validate: [
      {
        validator: uniqueEmailValidator,
        message: 'Email already exists'
      }
    ],
    // 添加唯一索引
    unique: true
  }
});

这样既可以在应用层给用户友好的错误提示，也能在数据库层面兜底避免重复数据。

内容的提问来源于stack exchange，提问作者Alaksandar Jesus Gene