Node.js无法连接MongoDB问题求助及已尝试方案

第一步：捕获连接错误，明确问题根源 #

你的代码未处理connect回调的err参数，导致无法定位具体错误。先修改代码添加错误捕获：

const mongodb = require('mongodb');
const connectionString = 'mongodb://127.0.0.1:27017';

const connection = new mongodb.MongoClient(connectionString, {
    useUnifiedTopology: true
});
console.log('connecting next');
connection.connect((err, client) => {
    // 优先处理连接错误
    if (err) {
        console.error('连接失败:', err);
        return;
    }
    console.log('connected.');
    const db = client.db('testdb');
    const collection = db.collection('collectionTest');
    const query = collection.find({});
    query.toArray((err, data) => {
        if (err) {
            console.error('查询失败:', err);
            return;
        }
        console.log(data);
        // 操作完成后关闭连接
        client.close();
    });
})

运行后查看错误日志，就能精准定位问题所在。

常见问题及解决方案 #

1. 驱动与MongoDB版本不兼容 #

若使用mongodb驱动v4.x+，useUnifiedTopology参数已默认启用，无需手动设置；针对MongoDB 6.x版本，需在连接字符串添加directConnection=true强制直连单实例（默认集群模式）：

const connectionString = 'mongodb://127.0.0.1:27017/?directConnection=true';

驱动与MongoDB版本对应关系参考：

• MongoDB 6.x 适配驱动v4.10+
• MongoDB 5.x 适配驱动v4.2+
• MongoDB 4.x 适配驱动v3.6+
  执行以下命令查看当前驱动版本：

npm list mongodb

版本不匹配时，安装对应版本驱动：

# 示例：安装适配MongoDB 6的驱动版本
npm install mongodb@4.17

2. 本地网络或端口异常 #

虽然mongo命令可正常连接，仍需确认Node.js能否访问27017端口：

# Windows系统
Test-NetConnection 127.0.0.1 -Port 27017
# macOS/Linux系统
nc -zv 127.0.0.1 27017

若端口不通，检查本地防火墙是否拦截Node.js进程，或是否有其他程序占用27017端口。

3. 改用async/await写法（更易维护） #

回调写法易遗漏错误处理，推荐使用async/await：

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

async function main() {
    const connectionString = 'mongodb://127.0.0.1:27017/?directConnection=true';
    let client;
    try {
        client = await MongoClient.connect(connectionString);
        console.log('连接成功');
        const db = client.db('testdb');
        const collection = db.collection('collectionTest');
        const data = await collection.find({}).toArray();
        console.log(data);
    } catch (err) {
        console.error('操作失败:', err);
    } finally {
        if (client) await client.close();
    }
}

main();

内容的提问来源于stack exchange，提问作者Plamen Chichkov