MongoDB 连接行为解析：为何错误的数据库名或端口不立即报错？_技术教程

mongodb 驱动默认延迟报错，数据库名不存在会自动创建，端口错误仅在超时后触发；而连接事件监听必须在 `connect()` 调用前注册，否则会错过“connected”事件。

在使用 Mongoose 连接 MongoDB 时，初学者常困惑于“为何改错数据库名（如 rec-db）或端口（如 270）却不抛异常”，甚至发现 database.once("connected", ...) 回调从未执行——这并非 Bug，而是由 MongoDB 协议设计、Mongoose 连接机制与事件监听时机共同决定的行为。下面逐一解析并提供最佳实践。

✅ 为什么错库名、错端口不立即报错？

数据库名不存在 ≠ 错误：MongoDB 采用“按需创建”策略。当你连接 mongodb://127.0.0.1:27017/rec-db 时，只要 URI 格式合法、服务可达，连接即视为成功；rec-db 会在首次插入数据时被自动创建。因此 mongoose.connect() 不会因库名不存在而 reject。
端口错误（如 270）延迟失败：Mongoose 底层驱动会尝试建立 TCP 连接，但不会立刻失败——它遵循网络超时机制（默认约 30 秒）。此时 await mongoose.connect(...) 将挂起，最终以 MongoServerSelectionError 或 MongoTimeoutError 拒绝 Promise。你需主动设置超时选项增强健壮性：

await mongoose.connect("mongodb://127.0.0.1:270/recipe-db", {
  serverSelectionTimeoutMS: 5000, // 5秒内选不到服务器即报错
  connectTimeoutMS: 5000,         // 连接建立超时
});

协议错误（如 moodb://）立即报错：URI 解析阶段即失败，因 moodb 不是 Mongoose 支持的协议（仅 mongodb://, mongodb+srv://），直接抛出 MongooseServerSelectionError 或解析异常，catch 可捕获。

✅ 为什么 "connected" 事件没触发？

根本原因：事件监听器注册晚于事件触发时机。mongoose.connect() 是异步操作，但其内部可能在 DNS 解析、TCP 握手完成瞬间就发出 "connected" 事件。若你在 await connect() 之后才调用 database.once("connected", ...)，此时事件早已发生且被丢弃（once 不支持“重放已触发事件”）。

✅ 正确做法：始终先注册监听器，再调用 connect()：

import mongoose from "mongoose";

// ✅ 步骤1：提前绑定事件
mongoose.connection.once("connected", () => {
  console.log("✅ Database connected successfully");
});

mongoose.connection.on("error", (err) => {
  console.error("❌ Database connection error:", err.message);
});

mongoose.connection.on("disconnected", () => {
  console.warn("⚠️ Database disconnected");
});

// ✅ 步骤2：发起连接（此时监听器已就绪）
await mongoose.connect("mongodb://127.0.0.1:27017/recipe-db", {
  serverSelectionTimeoutMS: 5000,
  connectTimeoutMS: 5000,
});