Node.js连接MongoDB赋值外部变量时报错,如何封装返回find()结果的模块
错误根因拆解
当前报错是几个核心逻辑问题叠加导致的:
- 异步时序错位:
MongoClient.connect()是非阻塞的异步方法,它的回调函数不会阻断后续同步代码的执行。刚发起连接请求时,回调还未触发给client变量赋值,代码就已经往下执行client.db('db'),这时候client还是初始的undefined,自然触发属性读取错误。 - 驱动接口认知偏差:MongoDB 3.0+版本的官方驱动里,
connect()方法的第二个回调参数是客户端连接实例,不是数据库实例。哪怕等待连接成功,把拿到的参数赋值给client变量,后续调用client.db()的逻辑也是不成立的。 - 基础逻辑bug:代码开头声明了
let client,实例化客户端时却直接使用未声明的mongoClient变量,变量逻辑混乱;刚初始化完连接就执行client.close(),就算时序正确,连接也会被立刻关闭,根本无法支撑后续查询。
可复用连接模块的正确实现
要实现可返回MongoDB.find()查询结果的通用模块,核心思路是把异步连接流程封装成可等待的Promise,全局缓存连接实例做复用,等连接真正建立完成后再对外暴露可调用的集合方法,不要在顶层同步代码里直接读取尚未初始化的连接对象。
参考实现可直接作为独立db模块使用:
const { MongoClient } = require('mongodb') // 全局缓存连接实例,避免每次查询都新建连接 let cachedClient = null let cachedDb = null async function connectToDatabase() { // 已有缓存连接直接复用,减少重复连接的开销 if (cachedClient && cachedDb) { return cachedDb } const client = new MongoClient('mongodb://localhost:27017/') // 必须等待连接建立完成,不能跳过await直接写后续逻辑 await client.connect() const db = client.db('db') // 存入全局缓存 cachedClient = client cachedDb = db return db } /** * 获取指定名称的集合实例 * @param {string} collectionName 集合名 * @returns {Promise<Collection>} 可直接调用find、insert等方法的集合对象 */ async function getCollection(collectionName) { const db = await connectToDatabase() return db.collection(collectionName) } module.exports = { connectToDatabase, getCollection }
模块使用示例
在业务代码中只需await拿到集合实例,就可以直接调用find方法获取查询结果:
const { getCollection } = require('./mongo') async function findCollectionData() { const targetCollection = await getCollection('collection') // find返回游标,调用toArray()即可拿到完整的查询结果数组 const result = await targetCollection.find({}).toArray() return result } // 调用测试 findCollectionData() .then(res => console.log('查询结果', res)) .catch(err => console.error('查询出错', err))
常见注意事项
- 不要在连接初始化流程中随意调用
client.close():数据库连接是需要长期复用的长连接,只有在Node进程退出、服务停机时才需要主动关闭连接 - MongoDB 4.0+以上版本的驱动已默认启用新的解析器和拓扑引擎,原代码中的
useUnifiedTopology: true、useNewUrlParser: true属于冗余配置,保留不会报错,但可删除简化代码 - 所有依赖连接实例的逻辑,必须在
connect()方法执行完成后再运行,不能用顶层同步逻辑读取尚未赋值的连接变量
内容的提问来源于stack exchange,提问作者droox
相关产品推荐
相关产品推荐

