码云项目RuoYi-Cloud启动跳坑指南

本文是对码云项目RuoYi-Cloud的讲解 点我下载RuoYi-Cloud

官方的文档 只简单阐述了下如何启动 还是有很多人启动不是很明白

一、拉取项目

下载项目后解压 然后导入IDEA 等待maven导入

二、导入数据库文件

数据库的脚本在项目根目录 /sql 文件夹下 建议数据库版本8.0或者5.7及以上

数据库脚本分三个:

1. ry-config.sql这个sql的作用是用作nacos配置文件持久化的,如果不知道nacos可以去What is Nacos了解nacos，大家nacos启动后配置中心一片空白那就是没有配置持久化。(需要导入)
2. ry-2020XXXX.sql系统的主要业务数据库,system模块访问业务用。(需要导入)
3. quartz.sql定时任务需要的数据库，如果需要定时任务则需要导入。(选择导入)

三、下载&配置Naocs

大家项目下载下来后找不到nacos 是因为项目中未携带nacos 需要自己去下载

官方最新Nacos版本同步地址

或者可以去RuoYi-Cloud官方群群文件获取 这里就不放群号了 在项目readme内有

文章使用的Naocs版本1.3.2

下载下来后是这样的 然后解压 解压后如下

然后我们要开始配置nacos的持久化 不然无法读取到数据库内的配置文件

我们点进 conf 文件夹

我们可以看到有个applicaiton.properties

然后我们要在尾部加入数据库的配置 就可以完成持久化

spring.datasource.platform=mysql
db.num=1
db.url.0=jdbc:mysql://127.0.0.1:3306/ry-config?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true
db.user=root
db.password=你的密码

保存到这里nacos的持久化就配置成功了

然后我们启动Nacos

启动步骤如下

我们回退到nacos的根目录然后点进去bin目录 可以看到里面有启动脚本 如果是linux机器 需要cd到当前目录 然后执行sh startup.sh -m standalone 启动脚本 如果是windows机器需要双击startup.cmd 启动 但是windows启动前需要修改一个地方

坑点可以看到这里默认启动的是集群模式 但是这样的启动就会出错 需要修改这里的cluster为standalone 然后保存 双击脚本startup.cmd 启动

nacos启动后我们前往配置中文修改数据库配置

nacos的管理后台地址一般是http://localhost:8848/nacos 然后到控制台登录页面后输入账号/密码 nacos / nacos 就可以登录成功了 然后我们来到配置管理->配置列表如果这个页面是空白 那证明 持久化 没配置成功请检查

可以看到这里有我们平常项目开发中用到的配置文件
一般修改的就是 auth & system & gatewat的配置文件 点击编辑修改mysql连接字段 如果是redis版本 请修改redis连接字段 不然无法加载验证码等

四、启动项目测试

我们回到IDEA然后就可以启动项目了 对了对了 nacos最好启动在8848端口这样的项目里就不用改东西了 不然要修改好几个服务的连接 如果没启动在8848端口修改位置在bootstrap.yml内修改

启动项目前做如下说明

 启动无顺序限制
 Auth服务和Gateway服务必须启动
 system服务如果你想访问后台就启动
 job和gen服务这两个一个是定时任务一个是代码生成 如果你有用得到就启动 反则不需要启动

本文先启动Gateway 然后再启动 Auth 启动过程就不展示了

小贴士:如果想知道配置文件是否加载 启动后在控制台 搜索 NacosPropertySourceBuilder 如果记录超过两条 就要小心配置是否加载成功了

system模块启动同理

然后项目就启动成功了

如果有其他问题出现可以加RuoYi官方QQ群：170157040 然后管理员列表找DokiYolo询问 或者 提交issues 会收到作者回复 或者直接加我QQ:857815116

补充:前端启动

请参考RuoYi-Cloud前端启动