MongoDB Node.js驱动无法连接27017端口及运行异常排查求助

1. 确认MongoDB服务器正常启动 #

• 启动mongod后，查看终端输出，必须出现waiting for connections on port 27017（默认端口）才说明服务正常。
• 如果报错：
  • 提示数据目录不存在：手动创建对应目录（Mac/Linux：mkdir -p /data/db；Windows：md C:\data\db），或者用mongod --dbpath /自定义路径指定数据目录。
  • 提示端口占用：用lsof -i :27017（Mac/Linux）或netstat -ano | findstr :27017（Windows）找到占用进程并杀掉，再重启mongod。

2. 定位"server running on port 3000"的来源 #

• 全局搜索你的app.js以及项目依赖文件，找包含3000或listen的代码段——这说明你的代码里（可能是不小心引入的Express或其他HTTP框架）启动了一个HTTP服务器，这个服务器会一直阻塞进程，导致终端无响应，同时输出该日志。
• 如果不需要这个HTTP服务，直接删除对应的监听代码；如果需要，要确保MongoDB的操作逻辑放在HTTP服务启动之前，或者在MongoDB操作完成后主动退出进程（比如调用process.exit()）。

3. 修正MongoDB操作代码 #

用Mongoose的情况： #

确保连接和插入逻辑正确，并且操作完成后关闭连接或退出进程：

const mongoose = require('mongoose');
const Fruit = mongoose.model('Fruit', new mongoose.Schema({ name: String }));

// 连接数据库
mongoose.connect('mongodb://localhost:27017/fruitDB')
  .then(() => {
    console.log('connected successfully to server');
    // 插入文档
    return Fruit.insertMany([
      { name: 'Apple' },
      { name: 'Banana' },
      { name: 'Orange' }
    ]);
  })
  .then(() => {
    console.log('inserted 3 documents into the collection');
    // 操作完成后退出进程，避免终端阻塞
    process.exit();
  })
  .catch(err => {
    console.error('操作失败:', err);
    process.exit(1);
  });

用原生MongoDB驱动的情况： #

const { MongoClient } = require('mongodb');
const uri = 'mongodb://localhost:27017/fruitDB';
const client = new MongoClient(uri);

async function run() {
  try {
    await client.connect();
    console.log('connected successfully to server');
    const db = client.db('fruitDB');
    const result = await db.collection('fruits').insertMany([
      { name: 'Apple' },
      { name: 'Banana' },
      { name: 'Orange' }
    ]);
    console.log(`inserted ${result.insertedCount} documents into the collection`);
  } catch (err) {
    console.error('操作失败:', err);
  } finally {
    // 必须关闭客户端连接
    await client.close();
    // 退出进程
    process.exit();
  }
}
run();

4. 验证数据库是否创建 #

MongoDB采用懒加载机制，只有当你插入数据后，数据库和集合才会真正被创建。操作完成后，打开新终端运行mongosh，输入以下命令检查：

show dbs; # 此时应该能看到fruitDB
use fruitDB;
db.fruits.find(); # 查看插入的文档

5. 终端无响应的额外处理 #

• 如果运行node app.js后终端一直挂着，按Ctrl+C终止进程，检查代码中是否有未关闭的连接、未退出的服务（比如HTTP服务器）。
• 确认没有多个mongod进程在运行：Mac/Linux用ps aux | grep mongod，Windows用tasklist | findstr mongod，杀掉多余进程后重新启动。

内容的提问来源于stack exchange，提问作者Babawale Fadare