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, });? 提示：mongoose.connection 是单例，无需额外赋值 database = mongoose.connection —— 直接使用更清晰。
? 最佳实践总结
- 使用 serverSelectionTimeoutMS 和 connectTimeoutMS 显式控制连接容错；
- 始终在 connect() 前注册 connected / error 事件监听器；
- 区分“连接成功”与“数据库存在”：前者由驱动保证，后者需业务层校验（如尝试 db.listCollections().toArray()）；
- 生产环境建议启用 retryWrites: true 和 w: “majority” 等高可用选项。
遵循以上模式，即可避免“静默失败”陷阱，构建健壮、可调试的 MongoDB 连接逻辑。