Next.js 14项目连接MongoDB Atlas失败求助：已配置IP白名单仍报错

问题排查与修复步骤 #

1. 环境变量配置校验 #

• 确认项目根目录.env.local文件中的MONGO_URI是从MongoDB Atlas复制的完整连接字符串，已替换<password>为数据库用户真实密码，且包含正确的数据库名称
• 修改后重启Next.js开发服务器，确保环境变量生效

2. 修复Mongoose连接的异步处理 #

当前db.js未等待异步连接完成，导致后续数据库操作执行时连接可能未建立，修改代码如下：

import mongoose from 'mongoose';

export const connect = async () => {
  try {
    // 等待连接完成，可选指定数据库名称
    await mongoose.connect(process.env.MONGO_URI, {
      dbName: '你的数据库名称' // 若连接字符串未包含，需补充
    });

    mongoose.connection.on('connected', () => {
      console.log("数据库连接成功");
    });

    // 新增错误监听，方便排查连接问题
    mongoose.connection.on('error', (err) => {
      console.error("数据库连接错误:", err);
    });
  } catch (error) {
    console.error("数据库连接失败", error);
    throw error; // 抛出错误让调用者处理
  }
};

3. 修正路由中的连接逻辑 #

Next.js 14 App Router的路由处理函数每次请求都会执行，直接调用connect()可能导致重复连接，添加连接状态检查：

import { NextRequest, NextResponse } from "next/server";
import { connect } from "@/dbConfig/db";
import Todo from "@/models/Todo";
import { v4 as uuidv4 } from "uuid";
import mongoose from "mongoose";

// 确保仅在未连接时建立连接
async function ensureConnection() {
  if (mongoose.connection.readyState !== 1) {
    await connect();
  }
}

export const GET = async (request: NextRequest) => {
  try {
    await ensureConnection();
    const todos = await Todo.find({});
    return NextResponse.json({
      msg: "查询所有待办事项成功",
      success: true,
      todos,
    });
  } catch (error) {
    console.error("获取待办事项错误:", error);
    return NextResponse.json({ msg: `发生错误: ${error}` }, { status: 500 });
  }
};

export const POST = async (request: NextRequest) => {
  try {
    await ensureConnection();
    const reqBody = await request.json();
    const { desc, category, priority } = reqBody;

    // 校验必填字段
    if (!desc || !category || !priority) {
      return NextResponse.json({ msg: "描述、分类和优先级为必填项" }, { status: 400 });
    }

    const newTodo = new Todo({
      id: uuidv4(),
      desc,
      completed: false,
      category,
      priority
    });

    const savedTodo = await newTodo.save();
    return NextResponse.json({
      msg: "待办事项创建成功",
      success: true,
      savedTodo,
    });
  } catch (error) {
    console.error("创建待办事项错误:", error);
    return NextResponse.json({ msg: `发生错误: ${error}` }, { status: 500 });
  }
};

export const DELETE = async (request: NextRequest) => {
  try {
    await ensureConnection();
    await Todo.deleteMany({});
    return NextResponse.json({
      msg: "所有待办事项已清空",
      success: true,
    });
  } catch (error) {
    console.error("清空待办事项错误:", error);
    return NextResponse.json({ msg: `发生错误: ${error}` }, { status: 500 });
  }
};

4. 检查MongoDB Atlas后台配置 #

• 确认数据库用户拥有readWrite权限
• 确认集群处于正常运行状态，无暂停或维护提示
• 用MongoDB Compass测试连接字符串是否能正常连接，排除网络或配置问题

5. 修复模型必填字段问题 #

你的TodoSchema中category和priority为必填项，但原POST请求未传入这两个字段，会导致保存失败，需在请求中补充获取这两个参数（如上述POST代码所示）

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