Node.js中如何用Mongoose预定义事件检测连接状态实现自定义熔断器

不要使用定时轮询方案，Mongoose的连接实例原生继承Node.js EventEmitter，提供了完整的连接生命周期事件，可以实时感知状态变更，零额外轮询开销，完全适配自定义熔断器的高频状态检测需求。

核心实现逻辑 #

全局维护连接状态变量，通过监听Mongoose预定义的连接事件实时更新状态，熔断器业务逻辑直接读取全局状态即可，不需要定时扫描readyState。
需要监听的核心事件如下：

• connected：首次和MongoDB建立连接成功，此时连接可用
• disconnected：连接断开，此时连接不可用
• reconnected：断线后重连成功，连接恢复可用
• error：连接抛出异常，连接不可用，可同步收集错误信息供熔断器计数
• close：连接被主动关闭，连接不可用

可直接复用的代码 #

const mongoose = require('mongoose');

// 全局状态变量，熔断器直接读取该值判断Mongo服务可用性
let mongoStatus = false;
// 记录上次状态变更时间，可用于熔断器半开探测、降级阈值判断
let lastStatusChangeTimestamp = Date.now();

/**
 * 统一更新连接状态，避免重复逻辑
 * @param {boolean} isAvailable 连接是否可用
 */
const setMongoStatus = (isAvailable) => {
  // 状态没变化时不做重复更新，减少不必要的回调触发
  if (mongoStatus === isAvailable) return;
  mongoStatus = isAvailable;
  lastStatusChangeTimestamp = Date.now();
  // 这里可以直接接入熔断器的状态变更钩子，实时触发熔断/恢复逻辑
  console.log(`[MongoDB] 连接状态更新，当前可用: ${isAvailable}`);
};

// 给默认连接实例绑定所有生命周期事件
const conn = mongoose.connection;
conn.on('connected', () => setMongoStatus(true));
conn.on('disconnected', () => setMongoStatus(false));
conn.on('reconnected', () => setMongoStatus(true));
conn.on('error', (err) => {
  setMongoStatus(false);
  console.error('[MongoDB] 连接异常:', err.message);
});
conn.on('close', () => setMongoStatus(false));

// 后续执行mongoose.connect(uri)启动连接即可，事件会自动触发状态更新

注意事项 #

如果业务中使用mongoose.createConnection()创建了多个独立的数据库连接实例，需要给每个实例单独绑定上述事件，不要直接复用全局mongoose.connection的状态。

和轮询方案的对比 #

• 无定时任务空耗，状态变更实时触发，不存在轮询间隔导致的状态感知延迟
• 不会出现轮询请求刚好命中连接闪断窗口导致的状态误判
• 状态变量常驻内存，高并发场景下读取性能远高于每次访问mongoose.connection.readyState属性
• 附带的状态变更时间戳可以直接复用到熔断器的阈值判断逻辑中，不需要额外维护计时逻辑

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