尝试向本地MongoDB插入数据时终端卡住，求解决方案

1. 补全Mongoose连接的状态监听代码 #

很多新手容易忽略连接事件的监听，导致终端没有任何反馈，误以为卡住。给你的连接代码加上成功/失败的回调或事件监听：

const mongoose = require('mongoose');

// IPv4连接URL，替换成你的数据库名
const dbUrl = 'mongodb://127.0.0.1:27017/yourTestDB';

mongoose.connect(dbUrl, {
  useNewUrlParser: true,
  useUnifiedTopology: true
})
.then(() => {
  console.log('MongoDB连接成功');
  // 可在此处添加插入数据的测试代码
})
.catch(err => {
  console.error('连接失败:', err);
});

// 额外监听连接事件，确保捕获所有状态
mongoose.connection.on('error', err => {
  console.error('连接异常:', err);
});
mongoose.connection.on('disconnected', () => {
  console.log('连接断开');
});

运行这个最简脚本，观察终端是否有输出。如果依旧无反应，继续下一步排查。

2. 验证MongoDB服务是否正常运行 #

打开运行mongod的终端，确认最后一行输出为：waiting for connections on port 27017。如果不是，说明mongod启动失败：

• 检查数据目录权限：默认数据目录为/data/db，需确保该目录存在且有读写权限，可通过以下命令修复：

  sudo mkdir -p /data/db
  sudo chmod 777 /data/db
  

• 检查端口占用：用lsof -i :27017（Linux/macOS）或netstat -ano | findstr :27017（Windows）查看27017端口是否被其他进程占用，若占用则杀死对应进程或修改MongoDB端口。

3. 检查连接URL的正确性 #

确保IPv4连接URL格式无误：

• 必须指定数据库名（如示例中的yourTestDB），否则Mongoose不会自动创建数据库，也无反馈。
• 不要遗漏默认端口号27017，若你的mongod使用了其他端口，需对应修改URL。

4. 排查Node进程阻塞问题 #

如果连接成功但终端卡住，可能是Node进程未主动退出。在数据插入完成后手动关闭连接：

// 插入数据示例
const TestModel = mongoose.model('Test', new mongoose.Schema({ name: String }));
TestModel.create({ name: 'test data' })
.then(doc => {
  console.log('数据插入成功:', doc);
  mongoose.connection.close(); // 关闭连接，让进程退出
})
.catch(err => {
  console.error('插入失败:', err);
  mongoose.connection.close();
});

5. 检查Mongoose与MongoDB版本兼容性 #

确认两者版本是否兼容：

• 查看MongoDB版本：mongod --version
• 查看Mongoose版本：npm list mongoose
• 例如MongoDB 5.x+建议搭配Mongoose 6.x及以上版本，版本不匹配可尝试升级/降级Mongoose：

  npm install mongoose@latest
  

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