RAP2-Dolores 常见问题解决方案

RAP2-Dolores 常见问题解决方案

项目基础介绍

RAP2-Dolores 是阿里妈妈前端团队开发的一个全栈式 API 管理平台，它是基于原有 RAP1 进行深度优化和增强的版本。该项目致力于提供一个集文档编写、测试、协作于一体的解决方案，帮助开发者更加高效地管理和维护 API。RAP2-Dolores 主要使用 TypeScript 和 Sass 进行开发，前端基于 React 框架，后端基于 Koa 和 MySQL。

新手使用注意事项及解决方案

1. 配置文件中的后端服务器地址未修改

问题描述：在开发或生产环境中，配置文件中的后端服务器地址未修改，导致前端无法正确连接到后端服务。

解决步骤：

1. 打开项目根目录下的 /src/config/config.dev.js 文件（开发模式）或 /src/config/config.prod.js 文件（生产模式）。
2. 找到 serverAPI 配置项，将其修改为实际的后端服务器地址，例如 http://your-server-address:port。
3. 保存文件并重新启动项目。

2. 依赖包未正确安装

问题描述：在运行 npm install 时，由于网络问题或依赖包版本不兼容，导致依赖包未正确安装。

解决步骤：

1. 确保网络连接正常，可以访问 npm 官方仓库。
2. 删除项目根目录下的 node_modules 文件夹和 package-lock.json 文件。
3. 重新运行 npm install 命令，确保所有依赖包正确安装。
4. 如果问题依旧存在，可以尝试使用 npm install --legacy-peer-deps 或 npm install --force 强制安装依赖。

3. 生产环境部署问题

问题描述：在生产环境中部署项目时，静态资源未正确编译或服务器配置错误，导致前端无法正常访问。

解决步骤：

1. 确保在生产环境中运行 npm run build 命令，生成静态资源文件到 build 目录。
2. 使用 serve 命令或配置 Nginx 服务器，将静态资源目录指向 build 文件夹。例如，使用 serve -s /build -p 80 命令启动静态服务器。
3. 检查服务器配置，确保端口和路径配置正确，能够正确访问静态资源。

通过以上步骤，新手用户可以更好地理解和解决在使用 RAP2-Dolores 项目时可能遇到的问题。