Mongoose报错OverwriteModelError：无法覆盖已编译的User模型求解决

创建名为User的Mongoose模型后，在两个不同控制器中导入时抛出错误：

OverwriteModelError: Cannot overwrite User model once compiled. at Mongoose.model

相关代码 #

User模型（User.js） #

import mongoose from "mongoose";

const UserSchema = new mongoose.Schema(
  {
    name: {
      type: String,
      required: true,
      min: 2,
      max: 100,
    },
    email: {
      type: String,
      required: true,
      max: 50,
      unique: true,
    },
    password: {
      type: String,
      required: true,
      min: 5,
    },
    city: String,
    state: String,
    country: String,
    occupation: String,
    phoneNumber: String,
    transactions: Array,
    role: {
      type: String,
      enum: ["user", "admin", "superadmin"],
      default: "admin",
    },
  },
  { timestamps: true }
);

const User = mongoose.model('User', UserSchema) ;
export default User;

控制器代码 #

Client.js

import User from "../models/User.js";

export const getCustomers = async (req, res) => {
  try {
    const customers = await User.find({ role: "user" }).select("-password");
    res.status(200).json(customers);
  } catch (error) {
    res.status(404).json({ message: error.message });
  }
};

General.js

import User from '../models/user.js'

export const getUser = async (req, res) => {
    try {
        const { id } = req.params;
        const user = await User.findById(id);
        res.status(200).json(user);
      } catch (error) {
        res.status(404).json({ message: error.message });
      }
}

1. 统一导入路径的大小写 #

两个控制器的导入路径大小写不一致：

• Client.js 使用 ../models/User.js（大写U开头）
• General.js 使用 ../models/user.js（小写u开头）

在Linux、macOS等大小写敏感的文件系统中，Node.js会将这两个路径识别为不同模块，导致模型文件被重复加载，触发重复定义错误。

修复方案：将所有导入语句的路径统一为相同大小写，例如：

import User from "../models/User.js";

2. 优化模型定义逻辑 #

即使路径统一，某些场景下仍可能出现重复加载问题。可以修改模型文件，先检查是否已有编译好的模型，再决定创建或复用：

修改User.js的最后两行：

// 替换原模型定义代码
const User = mongoose.models.User || mongoose.model('User', UserSchema);
export default User;

mongoose.models对象存储了所有已编译的模型，这样修改后会优先复用已存在的User模型，避免重复编译。

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