Vercel部署时遭遇Mongoose OverwriteModelError问题求助

问题场景 #

本地运行正常，但将代码部署到Vercel时出现以下错误：

Connected to MongoDB database
OverwriteModelError: Cannot overwrite `User` model once compiled.
    at Mongoose.model (/var/task/node_modules/mongoose/lib/mongoose.js:563:13)
    at Object.<anonymous> (/var/task/server.js:38:23)
    ...

且仅在一处定义了User模型。

问题原因 #

Vercel的Serverless函数环境中，函数实例可能被复用或多次冷启动，导致包含模型定义的模块被重复加载。而Mongoose不允许对同一名称的模型进行重复编译，因此触发该错误。

解决方案 #

修改模型定义代码，先检查模型是否已存在，存在则直接复用，不存在再创建新模型：

const userSchema = new mongoose.Schema(
    {
        email: { type: String, required: [true, "Email is required"] },
        password: { type: String, required: [true, "Password is required"] },
        phone: { type: String },
        orderhistory: [String],
        paymentinfo: {
            cardnumber: { type: String },
            CCV: { type: String },
            cardexpiry: { type: String },
        },
        listeditems: [String],
    },
    { collection: "Users" }
);
// 优先复用已编译的模型，避免重复定义
const User = mongoose.models.User || mongoose.model("User", userSchema);

代码说明 #

每次模块加载时，先通过mongoose.models.User检查Mongoose是否已注册过User模型：

• 如果已存在，直接使用已编译好的模型
• 如果不存在，才创建新的模型并完成编译

这种写法可以适配Serverless环境的模块重复加载场景，彻底解决模型重复编译的问题。

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