Node.js无法连接MongoClient求助：连接成功日志未输出

我编写了一个简单的Express程序用于连接MongoDB数据库，期望看到连接成功的日志，但该日志从未显示。已确认MongoDB服务器正常运行（通过MongoDB Compass验证），请帮忙排查连接失败原因。

程序代码如下：

const express = require('express');
const app = express();
const MongoClient = require('mongodb').MongoClient;
const assert = require('assert');
const bodyParser = require('body-parser');

let db = null;
const url = 'mongodb://localhost:27017';
const dbName = 'chatbotdb';

const jsonParser = bodyParser.json();
const urlencodedParser = bodyParser.urlencoded({extended: false});

app.use(jsonParser);
app.use(urlencodedParser);

MongoClient.connect(url, function(err, client) {
    assert.equal(null, err);
    console.log("This log is never shown.");

    db = client.db(dbName);
    
});

app.listen(3000);
console.log('Server running on: localhost:3000'); //this log is always shown

排查与解决方案 #

1. Assert抛出异常导致回调中断 #

原代码使用assert.equal(null, err)，一旦连接出错，assert会直接抛出异常，回调函数内的日志代码根本无法执行，且未做错误捕获，程序可能静默终止。

修复代码：

MongoClient.connect(url, function(err, client) {
    if (err) {
        console.error("MongoDB连接失败:", err);
        return;
    }
    console.log("MongoDB连接成功！");
    db = client.db(dbName);
});

2. 连接字符串可能存在问题 #

• 尝试用mongodb://127.0.0.1:27017替换localhost，避免DNS解析异常；
• 若MongoDB启用了认证，需在连接字符串中添加用户名密码信息，格式为：

  mongodb://用户名:密码@localhost:27017/chatbotdb?authSource=admin
  

3. 异步连接与服务启动顺序问题 #

原代码先启动服务器再处理数据库连接，虽不是日志不显示的直接原因，但建议在数据库连接成功后再启动服务，避免服务就绪但数据库未连接的情况：

MongoClient.connect(url, function(err, client) {
    if (err) {
        console.error("MongoDB连接失败:", err);
        process.exit(1); // 连接失败直接退出程序
    }
    console.log("MongoDB连接成功！");
    db = client.db(dbName);
    
    app.listen(3000, () => {
        console.log('Server running on: localhost:3000');
    });
});

4. 验证MongoDB端口监听状态 #

在终端执行对应命令，确认27017端口有MongoDB进程监听：

• Windows：netstat -ano | findstr :27017
• Mac/Linux：lsof -i :27017

内容的提问来源于stack exchange，提问作者Mind full of blanks