如何正确处理 mongodb 连接中的错误与事件监听时机
MongoDB 的连接行为常令初学者困惑：为何数据库名拼错（如 `rec-db`）或端口写错（如 `270`）不触发 `catch`？而协议写成 `moodb://` 却立刻报错？这并非 Bug，而是由 MongoDB 驱动的设计逻辑决定的。✅ 核心原理说明
数据库名不存在 ≠ 连接失败
MongoDB 采用“懒创建”策略：指定的数据库（如 recipe-db）在首次执行写操作（如 save()、insertOne()）时才真正创建。因此，mongoose.connect("mongodb://127.0.0.1:27017/rec-db") 不会报错——它成功连上了 MongoDB 服务，只是该库当前为空。连接本身是合法且成功的。端口错误不会立即失败，但终将超时
将端口误写为 270（如 "mongodb://127.0.0.1:270/recipe-db"）时，Node.js 会尝试建立 TCP 连接。由于 270 端口未运行 MongoDB 服务，操作系统会拒绝连接或等待超时。Mongoose 默认超时时间为 30 秒，此时才会抛出 ServerSelectionError 或 MongoNetworkError。它不会同步报错，所以 await connect() 在超时前看似“静默成功”，实则处于挂起状态。协议错误（如 moodb://）会立即抛出异常
mongoose.connect() 内部首先解析 URI。当协议非 mongodb:// 或 mongodb+srv:// 时（例如 moodb://...），Mongoose 会在解析阶段直接抛出 MongoInvalidArgumentError，因此能被顶层 catch() 捕获。connected 事件必须提前注册
mongoose.connect() 是异步函数，但其内部可能同步触发部分事件（如快速本地连接）。若你在 await mongoose.connect(...) 之后才调用 database.once("connected", ...)，事件很可能已在监听器注册前发生，导致回调永不执行——这就是你未看到 "Database connected" 的根本原因。
✅ 正确写法：事件监听 + 错误处理一体化
推荐使用以下结构，兼顾可读性、健壮性和时序安全：
import mongoose from 'mongoose';
async function connectToDB() {
// ✅ 关键：先注册事件监听器，再发起连接
mongoose.connection
.on('error', (err) => {
console.error('❌ MongoDB connection error:', err.message);
process.exit(1); // 或重试逻辑
})
.once('connected', () => {
console.log('✅ Database connected successfully');
})
.once('disconnected', () => {
console.warn('⚠️ MongoDB disconnected');
});
// ✅ 使用标准选项增强可靠性
try {
await mongoose.connect('mongodb://127.0.0.1:27017/recipe-db', {
serverSelectionTimeoutMS: 5000, // 5秒内选不到可用服务器即失败
socketTimeoutMS: 45000,
family: 4 // 强制 IPv4，避免 DNS 解析问题
});
} catch (err) {
console.error('? Connection failed:', err.message);
throw err;
}
}
// 启动入口
(async () => {
try {
await connectToDB();
console.log('? Server ready');
} catch (err) {
console.error('Fatal startup error:', err);
process.exit(1);
}
})();⚠️ 注意事项与最佳实践
- 不要依赖 database.once("connected") 的返回值做后续逻辑：连接成功后应通过 mongoose.connection.readyState === 1 判断状态，而非仅靠事件。
- 始终设置超时选项：serverSelectionTimeoutMS 可避免端口错误导致的长时间挂起。
- 生产环境务必使用 mongodb+srv:// + Atlas 或配置副本集，并启用 retryWrites=true。
- 连接失败时，不要静默忽略：记录错误并主动退出（process.exit(1)）或实现指数退避重连。
- 若需验证数据库是否存在，应在连接后执行 db.listCollections().toArray() 或查询某集合的 countDocuments({})，而非依赖连接阶段校验。
遵循以上模式，你将彻底规避“连接无报错却无日志”“端口错却不提醒”等典型陷阱，构建出稳定、可观测的 MongoDB 连接层。
