Next.js集成Mongoose报Cannot overwrite model once compiled错误如何解决

问题原因 #

Next.js 开发模式下的模块热重载会清空模块级变量缓存，你定义的shopModelCached每次热重载都会被重置为undefined，导致代码仍会重复调用mongoose.model注册同名模型，触发报错。

解决方案 #

修改数据库模型工具代码，同时利用global全局对象做缓存（热重载不会清空global对象）+ 优先复用 Mongoose 内置已注册的模型，改动后代码如下：

import mongoose from 'mongoose';
import shopSchema from './Schemas/shopSchema';

// 优先读取全局缓存的模型，热重载后不会丢失
let shopModelCached = global.shopModelCached || null;

async function getShopModel() {
  if (!shopModelCached) {
    try {
      // 避免重复连接数据库
      if (mongoose.connection.readyState !== 1) {
        await mongoose.connect(process.env.MONGO_DB_CONNECTION_STRING);
      }
      // 优先复用已注册的模型，不存在再新建
      shopModelCached = mongoose.models.shop || mongoose.model("shop", shopSchema);
      // 写入全局缓存
      global.shopModelCached = shopModelCached;
    } catch (err) {
      throw err;
    }
  }
  return shopModelCached;
}

export default getShopModel;

核心改动说明 #

• 把模型缓存挂载到global对象上，避免热重载时缓存丢失
• 新增数据库连接状态判断，避免重复触发数据库连接逻辑
• 优先读取mongoose.models中已存在的模型，从根源避免重复编译同名模型的错误

你原有的getServerSideProps代码不需要做任何改动，直接使用修改后的工具函数即可正常运行。

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