异常教程

Mac OSX 平台安装 MongoDB（超详细）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

在当今的软件开发领域，数据库管理是构建应用的核心环节之一。MongoDB 作为一款流行的 NoSQL 数据库，因其灵活的文档存储模式和高效的查询性能，在 Web 应用、数据分析等领域广受欢迎。对于 Mac OS X 用户而言，掌握 MongoDB 的安装与配置方法，不仅能提升开发效率，还能为后续的项目实践打下坚实基础。本文将从零开始，分步骤详解如何在 Mac OS X 平台安装 MongoDB，并通过实际案例帮助读者快速上手。

安装前的准备工作

1. 确认系统兼容性

MongoDB 支持 macOS 10.13（High Sierra）及以上版本。安装前，请通过终端输入以下命令检查系统版本：

sw_vers

该命令会输出 macOS 的版本信息，确保您的系统版本满足要求。

2. 安装 Homebrew（可选但推荐）

Homebrew 是 macOS 的包管理工具，能简化软件安装流程。若尚未安装 Homebrew，可在终端运行以下命令：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装完成后，可通过 brew --version 验证 Homebrew 是否生效。

3. 准备存储目录（手动安装时需用到）

MongoDB 默认需要指定数据存储目录和日志目录。建议在 /data/db 和 /log 路径下创建文件夹。若使用 Homebrew 安装，此步骤可跳过，系统会自动配置。

安装 MongoDB 的两种主流方式

方式一：通过 Homebrew 快速安装

步骤 1：使用 Homebrew 安装

在终端输入以下命令，Homebrew 会自动下载并安装 MongoDB 的最新稳定版本：

brew tap mongodb/brew  
brew install mongodb-community

此过程可能需要几分钟时间，具体取决于网络速度。

步骤 2：启动 MongoDB 服务

安装完成后，可通过以下命令启动 MongoDB 的守护进程：

brew services start mongodb-community

若需停止服务，可运行 brew services stop mongodb-community。

验证安装

打开新终端窗口，输入以下命令连接 MongoDB：

mongo

若成功进入 MongoDB Shell（显示 MongoDB shell version vX.X.X 等信息），则表示安装成功。

方式二：手动下载安装包（适合特定版本需求）

步骤 1：下载官方安装包

访问 MongoDB 官方下载页面 ，选择 macOS 版本并下载 .tgz 压缩包。

步骤 2：解压并配置目录

将下载的文件移动到 /usr/local 目录（或其他自定义路径），并解压：

sudo mv mongodb-osx-x86_64-<version>.tgz /usr/local  
cd /usr/local  
sudo tar -zxvf mongodb-osx-x86_64-<version>.tgz

解压后，将文件夹重命名为 mongodb 以便后续操作。

步骤 3：创建数据与日志目录

sudo mkdir -p /data/db  
sudo mkdir -p /log/mongodb

赋予目录权限：

sudo chown -R $USER /data/db  
sudo chown -R $USER /log/mongodb

步骤 4：启动 MongoDB

在终端中指定配置参数启动服务：

./mongodb/bin/mongod --dbpath=/data/db --logpath=/log/mongodb/mongod.log

若无报错信息，则服务已成功启动。

配置与验证 MongoDB

1. 配置文件优化

为避免每次启动时手动输入参数，建议创建配置文件。在 /etc 目录下新建 mongod.conf 文件：

sudo nano /etc/mongod.conf

在文件中添加以下内容（根据实际路径调整）：

storage:  
  dbPath: /data/db  
systemLog:  
  destination: file  
  path: /log/mongodb/mongod.log  
net:  
  port: 27017

保存后重启服务即可生效。

2. 连接与基本操作测试

通过以下命令进入 MongoDB Shell：

mongo

在 Shell 中执行以下测试命令：

// 创建数据库  
use mytestdb;  

// 创建集合（类似关系型数据库的表）  
db.createCollection("users");  

// 插入文档（数据记录）  
db.users.insertOne({ name: "Alice", age: 30 });  

// 查询数据  
db.users.find().pretty();

若成功返回插入的文档，则数据库功能正常。

实际案例：搭建一个简单的用户管理系统

案例背景

假设我们需要开发一个记录用户信息的系统，要求支持增删改查操作。

步骤 1：设计数据结构

MongoDB 的文档结构灵活，可直接定义字段：

{  
  "name": "Bob",  
  "age": 25,  
  "email": "bob@example.com",  
  "hobbies": ["reading", "coding"]  
}

步骤 2：实现增删改查

插入数据

db.users.insertOne({  
  name: "Charlie",  
  age: 28,  
  email: "charlie@example.com"  
});

查询数据

// 查询年龄大于25岁的用户  
db.users.find({ age: { $gt: 25 } });  

// 根据邮箱查询  
db.users.findOne({ email: "alice@example.com" });

更新数据

// 将年龄增加1岁  
db.users.updateOne({  
  name: "Alice"  
}, {  
  $inc: { age: 1 }  
});

删除数据

db.users.deleteOne({ name: "Bob" });

常见问题与解决方案

问题1：启动时提示 access denied for path

原因：MongoDB 默认需要特定目录的写入权限。
解决方法：

sudo chown -R $USER /data/db

问题2：端口 27017 被占用

解决方法：

  1. 查找占用端口的进程： 
    lsof -i :27017
  2. 终止进程： 
    kill -9 <PID>

问题3：连接超时或拒绝连接

可能原因：

  • MongoDB 服务未启动
  • 防火墙或网络配置阻止了端口访问

解决方法：

brew services list  

brew services restart mongodb-community

结论

通过本文的详细步骤，读者应能掌握在 Mac OS X 平台安装和配置 MongoDB 的方法。无论是通过 Homebrew 的一键式安装，还是手动配置的精细化控制，MongoDB 的灵活性和强大功能都能为开发工作提供有力支持。对于初学者而言，建议从简单的 CRUD 操作开始，逐步探索聚合查询、索引优化等高级功能。掌握 MongoDB 的安装与基础操作后，您将能够快速搭建数据驱动的 Web 应用或数据分析项目。

未来，随着 MongoDB 版本的更新，其功能会持续扩展。建议开发者定期关注官方文档，以掌握最新特性。希望本文能成为您 MongoDB 学习旅程的起点！

最新发布

查看更多文章