Node.js中Mongoose模型导出函数至控制器报错：register不是函数

问题根源分析 #

你遇到的TypeError: User.register is not a function及后续逻辑错误，主要源于以下几点：

• 未基于Schema生成Mongoose Model实例，仅导出普通函数，导致控制器无法通过模型调用方法
• 函数未挂载为Mongoose模型的静态方法，无法通过User.register()形式调用
• 普通函数内的this不指向Mongoose模型，this.find()、this.insertOne()调用无效，且insertOne并非Mongoose模型的API
• 参数传递不匹配：控制器传单个对象，而函数定义了多个独立参数
• 存在性判断逻辑错误：find()返回数组，空数组会被误判为true

修复步骤与完整代码 #

1. 修正User.js模型文件 #

const mongoose = require('mongoose');
const bcrypt = require('bcrypt');
const Schema = mongoose.Schema;

const usersSchema = new Schema({
  name: { type: String, required: true },
  username: { type: String, required: true, unique: true },
  email: { type: String, required: true, unique: true },
  password: { type: String, required: true }, // 密码无需设置unique
  verified: { type: Boolean, default: false },
});

// 将register定义为模型静态方法，this指向Model本身
usersSchema.statics.register = async function({ name, username, email, password, verified = false }) {
  // 用findOne高效检查用户是否存在
  const exists = await this.findOne({ email });
  if (exists) {
    throw new Error("User Already Exists");
  }

  const salt = await bcrypt.genSalt(10);
  const hash = await bcrypt.hash(password, salt);

  // 使用Mongoose的create方法创建用户
  const user = await this.create({
    name,
    username,
    email,
    password: hash,
    verified
  });

  return user;
};

// 导出Mongoose Model
module.exports = mongoose.model('User', usersSchema);

2. 修正UsersController.js控制器文件 #

const User = require('../models/User');
const express = require('express');
const router = express.Router();

router.post('/register', async (req, res, next) => {
  try {
    // 直接传递req.body，与静态方法的参数结构匹配
    const user = await User.register(req.body);
    res.json({ 
      msg: "registered",
      user: { id: user._id, name: user.name, email: user.email }
    });
  } catch (err) {
    // 捕获并返回错误信息
    res.status(400).json({ msg: err.message });
  }
});

module.exports = router;

关键说明 #

• Mongoose静态方法：通过schema.statics定义的方法会挂载到Model构造函数上，调用时this指向Model，可直接使用Mongoose的查询/创建API
• 异步错误处理：用async/await配合try/catch捕获异常，比链式then/catch更清晰易维护
• MongoDB与Mongoose差异：优先使用Mongoose封装的create、findOne等方法，而非原生驱动的insertOne

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