Next.js + Mongoose创建MongoDB Filament集合失败求助

背景 #

我正在开发一个3D打印网站，目前在MongoDB数据库操作中遇到问题：编写POST接口用于创建新的Filament对象，但MongoDB Atlas中并未按预期生成对应的集合。

定义的Schema #

Printer Schema #

{
    "price": Number,
    "name": String,
    "image": String,
    "bg": String,
    "availability": String,
    "speed": Number // (mm of filament)/s
}

Filament Schema #

{
    "price": Number,
    "name": String,
    "image": String,
    "bg": String,
    "length": Number
}

项目结构 #

采用Next.js标准结构，核心目录包括：

• models：存放数据模型文件
• libs：存放数据库连接逻辑
• app/api/filament：存放POST接口路由文件

MongoDB Atlas配置 #

已创建集群，配置了数据库访问用户，且将当前环境IP加入了Atlas的IP白名单。

Postman请求情况 #

向接口发送POST请求，请求体为JSON格式，包含price、name、image、bg、length字段。

代码详情 #

route.js #

import Filement from "@/models/filement";
import { NextResponse } from "next/server";
import { connectMongoDB } from "@/libs/mongodb";

export async function POST(req) {
    const {price, name, image, bg, length} = await req.json();

    await connectMongoDB();
    await Filement.create({price, name, image, bg, length});

    return NextResponse.json({ message: "Filament created successfully" }, { status: 201 });
}

mongodb.js #

import mongoose from "mongoose";

const connectMongoDB = async () => {
    try {
        await mongoose.connect(process.env.MONGODB_URI);
        console.log("Connection to Database: OK");
    } catch (error) {
        console.log("Connection to Database: FAILED");
        console.log(error);
    }
};

export default connectMongoDB;

filement.js #

import mongoose, { Schema } from "mongoose";

const filementSchema = new Schema({
    price: Number,
    name: String,
    image: String,
    bg: String,
    length: Number
});

const Filement = mongoose.model.Filement || mongoose.model("Filement", filementSchema);

export default Filement;

问题现象 #

多次确认MONGODB_URI正确性，重启服务器、验证URL、安装依赖后，MongoDB Atlas中仍未创建目标集合，同时出现相关错误。

排查思路与解决方案建议 #

• 修正拼写错误：模型文件名filement.js和代码中的Filement均为拼写错误，应改为filament.js和Filament，确保业务名称与代码一致，避免mongoose生成不符合预期的集合名（默认会将模型名转为小写复数，错误拼写会生成filements而非预期的filaments）。
• 优化模型注册逻辑：将模型注册代码改为标准写法，避免潜在的模型重复注册问题：

  const Filament = mongoose.models.Filament || mongoose.model("Filament", filamentSchema);
  

• 添加接口错误捕获：在POST接口中加入try-catch块，返回具体错误信息，便于定位问题：

  export async function POST(req) {
    try {
      const {price, name, image, bg, length} = await req.json();
      await connectMongoDB();
      await Filament.create({price, name, image, bg, length});
      return NextResponse.json({ message: "Filament created successfully" }, { status: 201 });
    } catch (error) {
      return NextResponse.json({ message: "Failed to create filament", error: error.message }, { status: 500 });
    }
  }
  

• 验证数据库连接状态：启动服务器后查看控制台是否打印Connection to Database: OK，若未打印，检查：
  • .env.local文件中MONGODB_URI是否配置正确
  • 环境变量是否在服务器重启后生效（Next.js需重启服务加载新的环境变量）
• 检查Atlas集合显示：MongoDB Atlas默认仅显示包含数据的集合，若插入成功但未显示，可手动刷新页面或通过Atlas的命令行工具查询集合
• 确认IP白名单：再次验证Atlas的IP白名单是否包含当前运行环境的IP，可临时设置为0.0.0.0/0测试（生产环境禁用此设置）

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