Mongoose中User.register函数运行异常，无法存储凭证至数据库

核心排查方向及修复方案 #

1. 确认User模型已正确集成passport-local-mongoose #

User.register是passport-local-mongoose插件提供的扩展方法，并非Mongoose原生API。若模型未挂载该插件，会直接触发异常。

• 修复代码（模型文件）：

const mongoose = require('mongoose');
const passportLocalMongoose = require('passport-local-mongoose');

const UserSchema = new mongoose.Schema({
  // 自定义字段（如nickname、email等）
});

// 必须挂载插件，启用register方法及密码加密逻辑
UserSchema.plugin(passportLocalMongoose);

module.exports = mongoose.model('User', UserSchema);

2. 修正register方法的参数传递 #

User.register的正确调用格式为：User.register(用户实例, 明文密码, 回调函数)，不能直接传入req.body对象作为第一个参数。

• 错误示例（常见误区）：

// 错误：直接传req.body，而非构造好的User实例
User.register(req.body, req.body.password, (err, user) => { ... })

• 修复后的路由代码：

User.register(
  new User({ username: req.body.username }), // 仅传入需手动设置的字段，密码由插件处理
  req.body.password,
  (err, user) => {
    if (err) {
      console.error(err);
      return res.redirect('/register');
    }
    // 后续认证逻辑
    passport.authenticate('local')(req, res, () => {
      res.redirect('/dashboard');
    });
  }
);

3. 检查依赖版本兼容性 #

passport-local-mongoose与mongoose、passport的版本不匹配可能导致隐蔽异常。

• 执行以下命令安装稳定兼容版本：

npm uninstall passport passport-local passport-local-mongoose mongoose
npm install passport@0.6.0 passport-local@1.0.0 passport-local-mongoose@7.1.2 mongoose@6.11.3

4. 自定义用户名字段的适配 #

若你的用户模型使用email而非默认的username作为登录标识，需在插件配置中声明：

// 模型文件中修改插件挂载逻辑
UserSchema.plugin(passportLocalMongoose, { usernameField: 'email' });

• 调用register时对应调整：

User.register(new User({ email: req.body.email }), req.body.password, callback)

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