RuoYi-App启动教程

<think>我们参考了多个与Ruoyi-Vue相关的引用，特别是关于启动方法和常见问题的解决方案。用户主要询问Ruoyi-Vue的启动方法和常见问题。注意，Ruoyi-Vue是一个前后端分离的权限管理系统，因此启动包括后端项目和前端项目。根据引用[2]：RuoYi-Vue教程中提到，前端项目（Vue部分）的启动步骤：1.克隆项目：gitclonehttps://gitee.com/ys-gitee/RuoYi-Vue3.git（注意：这里引用的是Vue3版本，但用户可能使用的是Vue2，不过方法类似）2.使用VSCode打开项目：code./RuoYi-Vue3然而，标准的Ruoyi-Vue（Vue2版本）项目地址通常是：https://gitee.com/y_project/RuoYi-Vue后端启动（SpringBoot）：通常需要导入数据库，修改数据库配置，然后运行后端项目。常见问题我们参考了引用[3],[4],[5]：1.前端依赖安装失败（如npminstall失败）：检查网络，使用镜像源，清理缓存。2.启动服务失败：检查端口占用，或配置错误。3.后端数据库连接失败：检查数据库配置（application-druid.yml），确保数据库服务启动。4.Redis连接问题：如果使用了Redis，需确保Redis服务运行。另外，根据引用[5]：RUOYI-VUE-PRO开发环境部署避坑指南中提到了前端项目启动后的访问地址：http://localhost，默认账号admin/123456。综合以上，我们给出Ruoyi-Vue（标准Vue2版本）的启动步骤：###Ruoyi-Vue启动方法1.后端启动：-克隆项目：`gitclonehttps://gitee.com/y_project/RuoYi-Vue.git`-导入数据库：使用SQL文件（在项目的sql目录下）创建数据库。-修改数据库配置：打开`ruoyi-admin`模块下的`resources/application-druid.yml`，修改数据库连接信息（URL、用户名、密码）。-运行后端：运行`RuoYiApplication.java`（位于`ruoyi-admin`模块的`com.ruoyi`包下）作为SpringBoot应用启动。2.前端启动：-进入前端目录：`cdruoyi-ui`-安装依赖：`npminstall`（若安装慢，可使用镜像：`npminstall--registry=https://registry.npmmirror.com`）-启动前端服务：`npmrundev`3.访问系统：-前端地址：`http://localhost:80`（默认端口80）-默认账号：admin/123456###常见问题及解决方案1.**npminstall失败**：-检查网络连接，尝试使用淘宝镜像：`npminstall--registry=https://registry.npmmirror.com`-清理缓存：`npmcacheclean--force`2.**后端启动报错（如数据库连接失败）**：-检查`application-druid.yml`中的数据库连接信息是否正确。-确保数据库服务已启动，且能够连接。3.**Redis连接失败**（若项目中使用Redis）：-检查Redis服务是否运行，可通过`redis-cliping`测试连通性。-在`application.yml`中检查Redis配置（主机、端口、密码）。4.**端口冲突**：-后端默认端口在`application.yml`中配置（server.port），前端端口在`ruoyi-ui`下的`vue.config.js`中配置（devServer.port）。-若端口被占用，可以修改为其他端口。5.**前端启动后页面空白**：-可能是路径配置问题，检查`vue.config.js`中的`publicPath`，开发环境应为`'/'`。6.**跨域问题**（前端访问后端接口时）：-后端已配置跨域（参考`CorsConfig.java`），确保前端访问的后端地址正确（在`ruoyi-ui`的`.env.development`文件中配置VUE_APP_BASE_API）。-或者通过Nginx代理解决。以上内容参考了引用[2][3][4][5][1]。</think> ### Ruoyi-Vue 启动方法及常见问题解决方案 #### **基础启动流程** 1. **后端启动（Spring Boot）** ```bash # 克隆项目 git clone https://gitee.com/y_project/RuoYi-Vue.git # 导入数据库 # 执行项目sql目录下的SQL脚本（如ry_xxx.sql和quartz.sql） # 修改配置文件 # 修改ruoyi-admin/src/main/resources/application-druid.yml中的数据库连接信息 # 启动后端 # 运行RuoyiApplication.java（主启动类） ``` 启动成功后会输出：`RuoYi started successfully in 5.234 seconds`[^4][^5]。 2. **前端启动（Vue.js）** ```bash # 进入前端目录 cd ruoyi-ui # 安装依赖（推荐使用国内镜像） npm install --registry=https://registry.npmmirror.com # 启动前端服务 npm run dev ``` 启动后访问：`http://localhost:80`（默认端口）[^2][^5]。 --- #### **常见问题解决方案** 1. **依赖安装失败** - **现象**：`npm install`卡住或报错 - **解决方案**： ```bash # 清理缓存并切换镜像源 npm cache clean --force npm install --registry=https://registry.npmmirror.com ``` > 引用[^3] 2. **数据库连接失败** - **现象**：`Communications link failure`或`Unknown database` - **解决方案**： 检查`application-druid.yml`中的配置项： ```yaml url: jdbc:mysql://localhost:3306/ry_vue?useUnicode=true username: root password: 你的数据库密码 # 确保与MySQL实际密码一致 ``` > 引用[^4][^5] 3. **Redis连接超时** - **现象**：`RedisTimeoutException` - **解决方案**： ```bash # 测试Redis服务状态 redis-cli ping # 应返回 PONG ``` 修改`application.yml`中的Redis配置： ```yaml redis: host: 127.0.0.1 port: 6379 password: "" # 若未设置密码留空 ``` > 引用[^5] 4. **前端页面空白/样式错乱** - **解决方案**： ```bash # 修改vue.config.js中的publicPath publicPath: process.env.NODE_ENV === "production" ? "/" : "/" ``` 执行：`npm run build` 重新构建 > 引用[^3][^5] 5. **端口冲突** - **解决方案**： 修改后端端口：`server.port=8081`（在`application.yml`中） 修改前端端口：`devServer.port=8081`（在`vue.config.js`中） > 引用[^5] --- #### **快速验证** 1. 访问`http://localhost`（前端） 2. 使用默认账号登录：**admin/123456** 3. 检查Swagger文档：`http://localhost:8080/swagger-ui.html`（后端接口） > 若仍失败，执行以下命令排除环境问题： > ```bash > mvn clean package # 后端重新打包 > rm -rf node_modules # 前端清理依赖 > ```