e-scooter-rental-system/docs/常见问题.md

常见问题

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

解决方案:

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 - 接口文档