104 lines
1.8 KiB
Markdown
104 lines
1.8 KiB
Markdown
# 快速开始指南
|
|
|
|
## 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`
|
|
- 如果目录不存在，手动创建:
|
|
```bash
|
|
mkdir C:\data\db
|
|
```
|
|
|
|
4. **启动 MongoDB**
|
|
- 如果安装为服务，会自动启动
|
|
- 或手动启动:
|
|
```bash
|
|
mongod --dbpath C:\data\db
|
|
```
|
|
|
|
### 使用 Docker 安装 (推荐)
|
|
|
|
```bash
|
|
# 拉取 MongoDB 镜像
|
|
docker pull mongo
|
|
|
|
# 启动 MongoDB 容器
|
|
docker run -d -p 27017:27017 --name mongodb mongo
|
|
```
|
|
|
|
## 2. 启动后端服务
|
|
|
|
### 安装依赖
|
|
```bash
|
|
cd E:\code\e-scooter-rental-system
|
|
npm install
|
|
```
|
|
|
|
### 启动开发服务器
|
|
```bash
|
|
npm run dev
|
|
```
|
|
|
|
### 验证服务
|
|
访问: http://localhost:3000/health
|
|
|
|
预期返回:
|
|
```json
|
|
{
|
|
"status": "ok",
|
|
"timestamp": "2026-03-05T06:06:20.281Z"
|
|
}
|
|
```
|
|
|
|
## 3. 测试 API 接口
|
|
|
|
### 使用 curl 测试
|
|
|
|
```bash
|
|
# 测试健康检查
|
|
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. ⏳ 开发前端页面
|