Node.js 服务连接 MongoDB 处理最佳实践

关于如何处理 node.js 服务连接 MongoDB，我查阅了大量中英文资料，发现并没有太适合我所期望的能力的方案，因此经过一番官方文档的研究，总结了以下的连接 MongoDB 的方法（使用目前 Node.js 平台最常用的 MongoDB ODM mongoose），斗胆称之为『最佳实践』，希望能够抛砖引玉，得到大家更专业的解答。 话不多说，先上代码：

const mongoose = require('mongoose')
const config = require('./config')


if (process.env.NODE_ENV === 'development') {
  mongoose.set('debug', true)    /* A */
}

mongoose.set('bufferCommands', false)  /* B */

function connectMongoDB(address) {
  try {
    mongoose.connect(address, { 
      useNewUrlParser: true,
      bufferMaxEntries: 0   /* B */
      autoReconnect: true   /* C, default is true, you can ignore it */
      poolSize: 5           /* D, default is 5, you can ignore it */
    })
    
    const db = mongoose.connection
    db.on('error', (error) => {
      console.log(`MongoDB connecting failed: ${error}`)
    })
    db.once('open', () => {
      console.log('MongoDB connecting succeeded')
    })
    return db
  } catch (error) {
    console.log(`MongoDB connecting failed: ${error}`)
  }
}

const mongoInstance = connectMongoDB(config.database.mongo)
module.exports = {
    mongoInstance
}
复制代码

这套连接方法能够满足以下需求，当然，这也是从我的服务需要满足的需求中总结而来的：

1. 开发环境下能够打印详细的数据库操作信息
2. 与数据库断开连接后，所有涉及到数据库读写操作的命令均会立即返回错误，而不会等待重连进而造成接口超时
3. 服务启动并成功与数据库建立连接后，如果数据库出现问题造成连接中断，服务会自动尝试重连直到连接成功
4. 无需手动处理连接数

我们逐条来看每个需求对应的配置：

bufferMaxEntries

bufferMaxEntries - The MongoDB driver also has its own buffering mechanism that kicks in when the driver is disconnected. Set this option to 0 and set bufferCommands to false on your schemas if you want your database operations to fail immediately when the driver is not connected, as opposed to waiting for reconnection. 核心意思就是将 bufferMaxEntries 设为 0 同时将 bufferCommands 设为 false，可以让驱动在未连接到数据库的时候，操作立即返回失败，而不是一直在等待重连。个人认为，这种方式相比一直等待数据库重连直到响应超时体验要更佳一点。

3. 见注释 C，这实际上是 mongoose 的默认设置，其连接数据库时的 config 参数 autoReconnect 默认为 true，其含义见文档：

autoReconnect - The underlying MongoDB driver will automatically try to reconnect when it loses connection to MongoDB. Unless you are an extremely advanced user that wants to manage their own connection pool, do not set this option to false. 如果非高级用户，就不要去改变这个参数了。

4. 见注释 D。对于 MongoDB 连接池的问题，建议是不要去手动处理。mongoose 自己会维护一个默认最大数量为 5 的连接池，只有当你发现有一些慢查询可能阻塞快查询时才应该考虑增大 poolSize。当然，这个数字不能设置得过大，MongoDB 默认是一个连接启动一个线程来服务，连接太多线程数切换系统开销会很大。

当然，以上这套『最佳实践』还存在一个不足：如果服务初次启动后未能成功连接数据库（比如数据库此时处于宕机状态），则服务不会尝试重连数据库。解决方法也不是没有，就是比较鸡肋：在 mongoose 连接的 'error' 事件监听回调函数中尝试重连。但是需要设置最大重试次数，否则会发生内存泄露。比较鸡肋的原因是，如果首次连接没有成功，短时间内尝试重连几次貌似也无济于事。因此，使用这套连接方式务必要注意数据库保持可连接状态。或者读者们如果有更好的解决方案，也希望能不吝赐教。

完。

本文首发于我的博客（点此查看），欢迎关注。