e-scooter-rental-system/docs/MongoDB安装指南.md

MongoDB 安装指南

为什么需要 MongoDB

两轮电动车租赁管理系统使用 MongoDB 作为数据库，用于存储车辆、订单、客户等数据。

安装方法

方法一：下载安装包 (推荐)

1. 下载 MongoDB

• 访问: https://www.mongodb.com/try/download/community
• 选择 Windows 版本
• 下载 MongoDB Community Server

2. 安装 MongoDB

• 运行下载的安装程序
• 选择 Complete 安装类型
• 勾选 Install MongoDB as a Service
• 点击 Install 开始安装

3. 配置数据目录

• 默认路径: C:\data\db
• 如果目录不存在，手动创建:

mkdir C:\data\db

4. 验证安装

打开命令提示符，输入:

mongod --version

如果显示版本信息，说明安装成功。

方法二：使用 Docker (推荐)

1. 安装 Docker Desktop

• 访问: https://www.docker.com/products/docker-desktop/
• 下载并安装 Docker Desktop for Windows
• 启动 Docker Desktop

2. 拉取 MongoDB 镜像

docker pull mongo

3. 启动 MongoDB 容器

docker run -d -p 27017:27017 --name mongodb mongo

4. 验证运行

docker ps

应该看到 mongodb 容器正在运行。

方法三：使用 MongoDB Compass (图形界面)

1. 下载 MongoDB Compass

• 访问: https://www.mongodb.com/try/download/compass
• 下载 Windows 版本

2. 安装 MongoDB Compass

• 运行安装程序
• 按照提示完成安装

3. 连接到本地 MongoDB

• 打开 MongoDB Compass
• 连接字符串: mongodb://localhost:27017
• 点击 Connect

启动 MongoDB

Windows 服务方式

如果安装时选择了 "Install MongoDB as a Service"，MongoDB 会自动启动。

手动启动

mongod --dbpath C:\data\db

Docker 方式

docker start mongodb

验证 MongoDB 运行

方法一：使用命令行

mongosh

如果进入 MongoDB Shell，说明运行正常。

方法二：使用 MongoDB Compass

• 打开 MongoDB Compass
• 连接到 mongodb://localhost:27017
• 如果连接成功，说明运行正常

常见问题

1. 端口被占用

如果 27017 端口被占用，可以修改端口:

mongod --port 27018 --dbpath C:\data\db

同时需要修改项目中的 .env 文件:

MONGODB_URI=mongodb://localhost:27018/e-scooter-rental

2. 数据目录权限问题

如果无法创建数据目录，尝试以管理员身份运行命令提示符。

3. Docker 连接失败

确保 Docker Desktop 正在运行，并且没有其他容器占用 27017 端口。

启动项目

1. 启动 MongoDB

确保 MongoDB 正在运行。

2. 启动后端服务

cd E:\code\e-scooter-rental-system
npm run dev

3. 生成测试数据

npm run seed

4. 测试 API

curl http://localhost:3000/health

下一步

安装完成后，按照以下顺序操作:

1. ✅ 安装 MongoDB
2. ✅ 启动 MongoDB
3. ✅ 启动后端服务
4. ✅ 生成测试数据
5. ✅ 测试 API 接口
6. ⏳ 开发前端页面