使用Next.js+Mongoose无法在MongoDB中创建文档的问题排查

核心问题 #

API返回创建成功但MongoDB控制台看不到文档，核心原因是集合名称不匹配，同时存在数据库连接逻辑不规范的问题。

具体修改步骤 #

1. 修正Schema文件（model/hw.js） #

原代码中Mongoose模型名称为circularss，会自动创建circularss集合，但你实际需要操作的是stuff数据库下的circulars集合。修改如下：

import mongoose from 'mongoose';

const circularsSchema = new mongoose.Schema({
    number: {
        unique: true,
        required: true,
        type: Number
    },
    text: {
        required: true,
        type: String
    }
});

// 明确指定集合名称为circulars，避免Mongoose自动复数化
const Circulars = mongoose.models.Circulars || mongoose.model('Circulars', circularsSchema, 'circulars');

export default Circulars;

2. 优化API接口文件 #

原API存在未导入mongoose、每次请求重复调用connect的问题，修改后的代码：

/**
 * @param {import("next").NextApiRequest} req
 * @param {import("next").NextApiResponse} res
 */
import mongoose from 'mongoose';
import Circulars from '../../../model/hw';

export default async function handler(req, res) {
    // 仅处理POST请求
    if (req.method !== 'POST') {
        return res.status(405).json({ error: '仅支持POST请求' });
    }

    try {
        // 检查数据库连接状态，避免重复连接
        if (mongoose.connections[0].readyState !== 1) {
            await mongoose.connect('mongodb+srv://usernameherer:passowordhere@cluster0.clusteridhere.mongodb.net/stuff?retryWrites=true&w=majority');
            console.log('已连接MongoDB');
        }

        const createdCircular = await Circulars.create(req.body);
        res.status(201).json({ createdCircular });
    } catch (error) {
        console.error(error);
        res.status(500).json({ error: error.message });
    }
}

关键说明 #

• 集合名称匹配：通过mongoose.model的第三个参数指定circulars，强制Mongoose使用目标集合，避免自动复数化导致的名称不一致。
• 连接逻辑优化：每次请求重复调用connect会造成连接冗余，检查连接状态后再连接更高效，符合Next.js的API运行机制。
• 规范导入：统一使用ES模块的import代替require，避免模块系统混用带来的潜在问题。

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