Node.js 18.13.x与MongoDB 6.0全局db变量配置及跨模块访问

首先得帮你理清你遇到的两个核心问题：

1. 第一个console.log(db)返回null，是因为MongoDB的连接是异步操作——你在连接回调完成前就打印了变量，此时db还没被赋值。
2. app.js里require后得到空值，是因为你的mongo.js没有导出任何变量，Node.js模块默认导出空对象（你看到的“空字符串”是打印时的表现问题）。

下面给你两种符合现代Node.js规范的解决方案，都是靠谱的生产级写法：

方案一：用Promise封装连接，导出获取DB实例的函数 #

这种方式灵活可控，还能避免全局变量带来的潜在维护问题，非常推荐。

修改后的mongo.js： #

const { MongoClient } = require("mongodb");

const url = 'mongodb://0.0.0.0:27017/';
const dbName = 'mydb';
let db = null;

// 封装初始化连接的函数，复用已有连接
async function connectDB() {
  if (db) {
    return db; // 已有连接直接返回，避免重复建立连接
  }
  try {
    const client = await MongoClient.connect(url);
    db = client.db(dbName);
    console.log('MongoDB连接成功');
    return db;
  } catch (err) {
    console.error('MongoDB连接失败:', err);
    throw err; // 抛出错误让调用者处理
  }
}

module.exports = connectDB;

在app.js中使用： #

const connectDB = require('./mongo.js');

// 用async/await确保拿到可用的DB实例
async function startApp() {
  const db = await connectDB();
  // 这里就可以正常操作数据库了，比如查询集合
  const userCollection = db.collection('users');
  const userList = await userCollection.find().toArray();
  console.log('查询到用户:', userList);
}

startApp();

方案二：直接导出已连接的DB实例（利用顶层await） #

Node.js 14.8+支持顶层await，Node.js 18完全兼容，这种写法更简洁，其他模块require时会自动等待连接完成。

修改后的mongo.js： #

const { MongoClient } = require("mongodb");

const url = 'mongodb://0.0.0.0:27017/';
const dbName = 'mydb';

try {
  const client = await MongoClient.connect(url);
  const db = client.db(dbName);
  console.log('MongoDB连接成功');
  module.exports = db;
} catch (err) {
  console.error('MongoDB连接失败:', err);
  process.exit(1); // 连接失败直接退出进程，避免后续业务逻辑报错
}

在app.js中使用： #

const db = require('./mongo.js');

// 直接使用db，因为require时已经等待连接完成了
async function queryData() {
  const orderCollection = db.collection('orders');
  const recentOrders = await orderCollection.find().limit(10).toArray();
  console.log('最近10条订单:', recentOrders);
}

queryData();

额外提醒 #

• 确保MongoDB服务已经在0.0.0.0:27017正常启动
• 如果需要更复杂的连接配置（比如用户名密码、SSL），可以在MongoClient.connect的第二个参数里添加对应选项，比如{ auth: { username: 'admin', password: '123456' } }

内容的提问来源于stack exchange，提问作者Maman Racing