macOS Big Sur下MongoDB 5.0无法启动及连接Node.js应用求助

一、解决mongod被系统拦截的问题 #

直接运行mongod时出现“无法检查恶意软件”提示，是macOS Gatekeeper拦截了未签名二进制文件，可按以下方式处理：

• 打开系统偏好设置 > 安全性与隐私 > 通用，下方会显示“mongod已被阻止打开”的提示，点击「允许」即可。
• 若需临时绕过全局检查（重启终端后生效），执行：

  sudo spctl --master-disable
  

  安全需求满足后，可执行sudo spctl --master-enable恢复Gatekeeper检查。

二、解决终端找不到mongod/mongo命令的问题 #

brew安装的MongoDB 5.0默认路径未加入系统PATH，需手动配置：

1. 打开zsh配置文件：

   open ~/.zshrc
   

2. 在文件末尾添加路径配置：

   export PATH="/usr/local/opt/mongodb-community@5.0/bin:$PATH"
   

3. 使配置生效：

   source ~/.zshrc
   

4. 验证：执行mongod --version和mongo --version，应正常输出版本信息。

另外你之前查看日志的命令有误，正确路径为：

cat /usr/local/var/log/mongodb/mongo.log

三、解决Node.js应用无法连接MongoDB的问题 #

1. 确认MongoDB服务状态 #

• 执行brew services list，确保mongodb-community@5.0状态为started
• 若服务启动异常，先清理数据目录（注意备份数据）再重启：

  brew services stop mongodb-community@5.0
  rm -rf /usr/local/var/mongodb
  brew services start mongodb-community@5.0
  

2. 调整代码与依赖 #

• 确保安装兼容的MongoDB驱动：

  npm install mongodb@4.x
  

• 原代码错误处理逻辑不完善，修改为以下形式以便排查问题：

  const MongoClient = require('mongodb').MongoClient;
  
  // Connection URL
  const url = 'mongodb://localhost:27017';
  // Database Name
  const dbName = 'fruitsDB';
  
  // Create a new MongoClient
  const client = new MongoClient(url);
  
  // Use connect method to connect to the Server
  client.connect(function(err) {
    if (err) {
      console.error("连接失败:", err);
      return;
    }
    console.log("Connected successfully to server");
  
    const db = client.db(dbName);
  
    insertDocuments(db, function() {
      client.close();
    });
  });
  
  const insertDocuments = function(db, callback) {
    // Get the documents collection
    const collection = db.collection('documents');
    // Insert some documents
    collection.insertMany([
      {a : 1},
      {a : 2},
      {a : 3}
    ], function(err, result) {
      if (err) {
        console.error("插入失败:", err);
        return;
      }
      console.log("Inserted 3 documents into the collection");
      callback(result);
    });
  }
  

• 运行node app.js后，若仍无输出，查看MongoDB日志，确认是否存在waiting for connections on port 27017的内容，以此验证服务是否正常监听端口。

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