# 常见问题

## MongoDB 相关

### 1. MongoDB 连接失败

**错误信息:**
```
connect ECONNREFUSED ::1:27017
connect ECONNREFUSED 127.0.0.1:27017
```

**原因:** MongoDB 未安装或未启动

**解决方案:**
1. 安装 MongoDB (推荐使用 Docker)
2. 启动 MongoDB
3. 重新启动后端服务

### 2. 端口被占用

**错误信息:**
```
EADDRINUSE: address already in use :::27017
```

**解决方案:**
1. 修改 .env 文件中的 MONGODB_URI
2. 或停止占用端口的服务

### 3. Docker 安装失败

**可能原因:**
- Docker Desktop 未启动
- 端口冲突
- 权限不足

**解决方案:**
1. 确保 Docker Desktop 正在运行
2. 检查端口是否被占用
3. 以管理员身份运行命令

## 后端服务相关

### 1. 端口被占用

**错误信息:**
```
Error: listen EADDRINUSE: address already in use :::3000
```

**解决方案:**
1. 修改 .env 文件中的 PORT
2. 或停止占用 3000 端口的服务

### 2. nodemon 未找到

**错误信息:**
```
'nodemon' is not recognized as an internal or external command
```

**解决方案:**
```bash
npm install nodemon --save-dev
```

### 3. 依赖安装失败

**解决方案:**
1. 清除 npm 缓存: `npm cache clean --force`
2. 删除 node_modules 文件夹
3. 重新安装: `npm install`

## API 相关

### 1. API 返回错误

**检查步骤:**
1. 确保 MongoDB 正在运行
2. 检查 API URL 是否正确
3. 查看后端日志

### 2. 跨域问题

**解决方案:**
- 已配置 CORS 中间件
- 确保前端正确配置代理

## 开发相关

### 1. 如何添加新功能

**步骤:**
1. 设计数据模型
2. 创建模型文件
3. 创建路由文件
4. 更新 API 文档
5. 测试接口

### 2. 如何修改现有功能

**步骤:**
1. 修改模型文件
2. 修改路由文件
3. 更新 API 文档
4. 测试接口

## 部署相关

### 1. 生产环境配置

**注意事项:**
1. 修改 .env 文件
2. 配置 MongoDB 远程连接
3. 配置 CORS 白名单
4. 启用 HTTPS

### 2. 性能优化

**建议:**
1. 使用 Redis 缓存
2. 优化数据库查询
3. 启用 gzip 压缩
4. 使用 CDN

## 联系方式

如果遇到其他问题，请查看:
- `docs/MongoDB安装指南.md` - 数据库安装
- `docs/快速开始.md` - 快速上手
- `docs/API.md` - 接口文档