e-scooter-rental-system/docs/快速开始.md

快速开始指南

1. 安装 MongoDB

Windows 安装步骤

1. 下载 MongoDB

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

2. 安装 MongoDB

   • 运行安装程序
   • 选择 "Complete" 安装类型
   • 勾选 "Install MongoDB as a Service"

3. 配置数据目录

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

   mkdir C:\data\db
   

4. 启动 MongoDB

   • 如果安装为服务，会自动启动
   • 或手动启动:

   mongod --dbpath C:\data\db
   

使用 Docker 安装 (推荐)

# 拉取 MongoDB 镜像
docker pull mongo

# 启动 MongoDB 容器
docker run -d -p 27017:27017 --name mongodb mongo

2. 启动后端服务

安装依赖

cd E:\code\e-scooter-rental-system
npm install

启动开发服务器

npm run dev

验证服务

访问: http://localhost:3000/health

预期返回:

{
  "status": "ok",
  "timestamp": "2026-03-05T06:06:20.281Z"
}

3. 测试 API 接口

使用 curl 测试

# 测试健康检查
curl http://localhost:3000/health

# 测试车辆列表 (需要先启动 MongoDB)
curl http://localhost:3000/api/vehicles

使用 Postman 测试

1. 打开 Postman
2. 创建新请求
3. 设置 URL: http://localhost:3000/api/vehicles
4. 设置方法: GET
5. 发送请求

4. 常见问题

MongoDB 连接失败

• 检查 MongoDB 是否启动
• 检查端口 27017 是否被占用
• 检查 .env 文件中的 MONGODB_URI 配置

端口被占用

• 修改 .env 文件中的 PORT 配置
• 或停止占用端口的其他服务

nodemon 命令未找到

• 运行: npm install nodemon --save-dev

5. 下一步

1. ✅ 后端服务已启动
2. ⏳ 安装并启动 MongoDB
3. ⏳ 测试 API 接口
4. ⏳ 开发前端页面