NextJS应用使用Mongoose切换数据库时模型未注册报错问题

报错本质是Mongoose模型注册逻辑和多数据库切换、NextJS运行机制不匹配导致的：

• 常规写法里mongoose.model('Car', CarSchema)会把模型注册到Mongoose全局默认连接上，不会自动同步到你缓存的其他独立数据库连接实例，你调用db.model('Car')的时候，当前db实例上根本没有注册过Car模型，就会抛出对应错误
• 模型文件里写的mongoose.models.Car || mongoose.model('Car', CarSchema)是单连接场景的适配写法，仅会在Mongoose全局实例上缓存模型，多连接场景下这个全局缓存的模型和你切换的目标数据库实例没有绑定关系
• NextJS开发模式的热重载会不定时清空Mongoose全局模型注册表，就算是单连接场景也容易偶发同类报错，多连接场景下问题触发概率会更高

1. 改造模型文件为工厂函数模式 #

不要把模型直接注册到全局Mongoose实例，改成接收数据库连接实例动态注册的形式：

// models/Car.js
const mongoose = require('mongoose');

const CarSchema = new mongoose.Schema({
  // 原有schema字段逻辑保持不变
},
{ timestamps: true });

// 导出模型创建方法，传入对应连接实例才会注册模型
module.exports = (connection) => {
  // 优先从当前连接的模型缓存读取，避免重复注册报错
  return connection.models.Car || connection.model('Car', CarSchema);
};

2. 调整业务侧查询逻辑 #

不要在文件顶部全局引入模型，等拿到目标数据库的连接实例后，再传入连接初始化对应模型：

// 业务查询代码
let db = cache.get(DB_NAME);
// 拿到目标库连接后，在当前连接实例上注册/获取Car模型
const Car = require('../models/Car')(db);
let allCars = await Car.find();

3. 补全连接缓存的校验逻辑 #

确保缓存中存储的是有效可用的数据库连接，避免拿到断开的无效连接触发异常：

• 缓存连接时校验连接状态，仅缓存readyState === 1（已成功连通）的连接实例
• 如果从缓存取到的连接状态异常，先重新建立对应数据库的连接，替换缓存中的失效连接后，再执行模型注册和查询操作

注意：多数据库连接场景下，不要在全局作用域提前调用mongoose.model注册模型，全局注册的模型默认绑定全局连接，无法直接跨连接实例复用，必须绑定到对应连接实例后才能查询对应库的数据。

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