在Next.js中正确导出Mongoose模型的方式及相关疑问

开发者阿泽

2026-7-11

关于Mongoose模型导出方式的疑问解答

我参考了Next.js官方示例中的Pet.js模型文件，代码如下：

import mongoose from 'mongoose'

const PetSchema = new mongoose.Schema({
  name: {
    type: String,
    required: [true, 'Please provide a name for this pet.'],
    maxlength: [60, 'Name cannot be more than 60 characters'],
  },
  owner_name: {
    type: String,
    required: [true, "Please provide the pet owner's name"],
    maxlength: [60, "Owner's Name cannot be more than 60 characters"],
  },
  species: {
    type: String,
    required: [true, 'Please specify the species of your pet.'],
    maxlength: [40, 'Species specified cannot be more than 40 characters'],
  },
  age: {
    type: Number,
  },
  poddy_trained: {
    type: Boolean,
  },
  diet: {
    type: Array,
  },
  image_url: {
    required: [true, 'Please provide an image url for this pet.'],
    type: String,
  },
  likes: {
    type: Array,
  },
  dislikes: {
    type: Array,
  },
})

export default mongoose.models.Pet || mongoose.model('Pet', PetSchema)

为什么要导出`mongoose.models.Pet || mongoose.model('Pet', PetSchema)`？

核心原因是适配Next.js的开发热重载机制：

Next.js开发阶段，代码变动会触发模块重新执行，如果每次都直接调用mongoose.model('Pet', PetSchema)，Mongoose会尝试重复注册同名模型，而它本身不允许这种操作，会抛出"Model already exists"的错误。
用mongoose.models.Pet || ...的逻辑，会先检查Mongoose内部的模型缓存（mongoose.models）里是否已经存在Pet模型，存在就直接复用已有的，不存在才创建新模型，完美避免了热重载时的重复注册报错。