Mongoose实例化模型报is not a constructor错误如何解决

问题场景 #

在Node.js项目中基于Mongoose操作MongoDB时，定义Problem模型Schema后，通过new Problem(data)实例化模型触发该报错。
涉及的模型定义代码：

const mongoose = require("mongoose");

const ProblemSchema = new mongoose.Schema(
  {
    slug: {
      type: String,
      required: true,
      unique: true,
    },
    title: {
      type: String,
      required: true,
    },
    desc: { type: String },
    input: { type: String, required: true },
    output: { type: String, required: true },
    constraints: { type: String },
    statement: { type: String, required: true },
    testcase: [
      {
        input: { type: String },
        output: { type: String },
        sample: { type: Boolean },
        explanation: { type: String },
      },
    ],
  },
  { timestamps: true }
);

module.exports = mongoose.model("Problem", ProblemSchema);

涉及的调用代码：

const Problem = require("./models/Problem");
const newData = new Problem(data)
await newData.save()

核心报错原因 #

该报错本质是通过require导入的Problem变量不是Mongoose编译生成的合法模型构造函数，常见触发原因有4种：

• 导入路径不匹配：./models/Problem路径没有指向你编写的Schema文件。比如models目录下同时存在Problem.js文件和Problem目录，Node.js会优先加载目录下的index.js，如果该index.js没有正确导出Problem模型，就会拿到非构造函数的对象。
• 模型重复注册：代码中多次执行mongoose.model("Problem", ProblemSchema)注册同名模型，会导致Mongoose抛出注册异常，最终返回的对象不是可用构造函数。
• 存在循环依赖：Problem模型文件和调用save方法的业务文件存在循环引用，Node.js处理循环依赖时会返回未完成初始化的导出对象，此时拿到的Problem不是合法构造函数。
• 初始化顺序错误：在Mongoose还未完成MongoDB连接时就加载模型、执行数据库操作，会导致模型编译失败，导入的对象不符合预期。

修复方案 #

按优先级逐一排查修复即可：

1. 校验导入路径
   补全文件后缀确认路径指向正确的Schema文件，避免同名目录/文件的加载优先级问题：

   // 明确指定文件后缀，避免加载到同名目录
   const Problem = require("./models/Problem.js");
   

2. 增加模型存在判断，避免重复注册
   修改模型文件的导出逻辑，优先复用已注册的模型，从根源避免重复注册问题：

   // 替换原来的module.exports = mongoose.model("Problem", ProblemSchema);
   module.exports = mongoose.models.Problem || mongoose.model("Problem", ProblemSchema);
   

3. 消除循环依赖
   梳理代码依赖关系，不要在Problem模型定义文件中引用调用该模型的业务逻辑文件，将模型定义和业务逻辑拆分为独立层级，切断循环引用链路。
4. 调整初始化顺序
   严格遵守「先连接数据库，再导入模型、执行数据库操作」的顺序，参考正确写法：

   const mongoose = require("mongoose");
   // 第一步：完成数据库连接
   await mongoose.connect("你的MongoDB连接地址");
   // 第二步：连接成功后再导入模型、执行操作
   const Problem = require("./models/Problem.js");
   const newData = new Problem(data);
   await newData.save();
   

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