如何从零开始二次开发RuoYI-Cloud后端项目？
- 内容介绍
- 文章标签
- 相关推荐
本文共计951个文字，预计阅读时间需要4分钟。
文章目录+前言+
一、下载RuoYi-Cloud后端项目+
二、更换项目名称+
1.更换项目及各个模块的名称+
2.更换包名称+
3.更新启动类名称+
文章目录
- 前言
- 一、下载RuoYi-Cloud后端项目
- 二、更换项目名称
- 1.更换项目及各个模块的名称
- 2.更换包名称
- 3.更新启动类名称
- 4.更改内部配置
- 6.数据库的配置
- 5.nacos的配置
- 踩坑点：
- 6. 项目成功运行起来
- 总结
前言
由于最近公司项目的整合，项目准备从Spring Boot-Vue的单体应用转向微服务架构,于是选用了免费开源的基于Spring Boot、Spring Cloud & Alibaba的分布式微服务架构权限管理系统的RuoYI-Cloud来作为脚手架，进行二次开发，下面就项目从下载到改为自己的项目的全过程遇到的坑点到成功运行给大家做个参考，如有错误，望指正。
一、下载RuoYi-Cloud后端项目
下载地址：gitee.com/y_project/RuoYi-Cloud
二、更换项目名称
1.更换项目及各个模块的名称
步骤如下：
1.下载项目到文件夹后不要打开项目
2.在文件夹中更改文件目录名称：包括所有的模块文件夹的名称，包名称不更改。
3.打开项目
*3.1.在idea中替换所有的pom.xml中涉及到 ruoyi的地方
3.2. 如果已经生成 iml 则更改 iml文件的名称涉及到 ruoyi的地方
3.3.重新构建
2.更换包名称
将包名rouyi更改为syw
3.更新启动类名称
将启动类变为Syw开头的SywxxxxAppilication.java
4.更改内部配置
1.common.security.annotation>>EnableCustomConfig
2.common.core.constant>>ServiceNameConstants
3.syw-gateway>>com.syw.common.swagger.config>>SwaggerWebConfiguration
4.com.syw.common.security.annotation>>EnableRyFeignClients
5.com.syw.gateway.config>>CaptchaConfig
6.更新所有的Application控制台打印信息
6.数据库的配置
1、运行sql文件
2、更改nacos的配置
表config_info，替换为自己的项目名称，或者直接调到nacos配置，直接从控制台进行修改，一定要替换掉所有包换ruoyi的字段为自己的项目名称，否则会启动不了。
5.nacos的配置
踩坑点：
1.如果是下载的是ruoyi-cloud-v2.4.0以上的版本(目前最新版为v3.0.0)，对应的nacos版本需要>2.0.0(目前最新版本为v2.0.2nacos下载官网) ，不然可能就会一直报类似这种错误>>
新下载的nacos它的application.properties文件里面的鉴权是打开的：### If turn on auth system: nacos.core.auth.enabled=true ，而若依的resources>>bootstrap.yml是没有配置nacos的账号和密码的，所以需要在bootstrap.yml中配置nacos的账户和密码（默认为nacos/nacos）。不然启动Application会报错naocs–403没有鉴权。
启动nacos，windows系统双击，nacos默认是集群版启动，要修改为单机版启动命令
1.Windows下载解压后（.zip），直接点击bin/startup.cmd -m standalone就可以了。 2.Nacos默认是集群模式cluster，可以startup.cmd属性MODE为单机模式standalone
启动后在浏览器中输入(localhost:8848/nacos)就可以访问了，默认的用户名和密码都是nacos
如果没有直接在ry-config数据库中修改content里面的(ruoyi)字段为自己的项目名称，就可以直接在nacos控制台修改所有的配置列表里面的（ruoyi）字段为自己的项目名。特别是Mapper扫描包的路径。
如果要修改顶级pom的<version>1.0.0</version>，则需要修改所有模块下的version版本号，不然回报ClassNotFind的错误。
6. 项目成功运行起来
本文共计951个文字，预计阅读时间需要4分钟。
文章目录+前言+
一、下载RuoYi-Cloud后端项目+
二、更换项目名称+
1.更换项目及各个模块的名称+
2.更换包名称+
3.更新启动类名称+
文章目录
- 前言
- 一、下载RuoYi-Cloud后端项目
- 二、更换项目名称
- 1.更换项目及各个模块的名称
- 2.更换包名称
- 3.更新启动类名称
- 4.更改内部配置
- 6.数据库的配置
- 5.nacos的配置
- 踩坑点：
- 6. 项目成功运行起来
- 总结
前言
由于最近公司项目的整合，项目准备从Spring Boot-Vue的单体应用转向微服务架构,于是选用了免费开源的基于Spring Boot、Spring Cloud & Alibaba的分布式微服务架构权限管理系统的RuoYI-Cloud来作为脚手架，进行二次开发，下面就项目从下载到改为自己的项目的全过程遇到的坑点到成功运行给大家做个参考，如有错误，望指正。
一、下载RuoYi-Cloud后端项目
下载地址：gitee.com/y_project/RuoYi-Cloud
二、更换项目名称
1.更换项目及各个模块的名称
步骤如下：
1.下载项目到文件夹后不要打开项目
2.在文件夹中更改文件目录名称：包括所有的模块文件夹的名称，包名称不更改。
3.打开项目
*3.1.在idea中替换所有的pom.xml中涉及到 ruoyi的地方
3.2. 如果已经生成 iml 则更改 iml文件的名称涉及到 ruoyi的地方
3.3.重新构建
2.更换包名称
将包名rouyi更改为syw
3.更新启动类名称
将启动类变为Syw开头的SywxxxxAppilication.java
4.更改内部配置
1.common.security.annotation>>EnableCustomConfig
2.common.core.constant>>ServiceNameConstants
3.syw-gateway>>com.syw.common.swagger.config>>SwaggerWebConfiguration
4.com.syw.common.security.annotation>>EnableRyFeignClients
5.com.syw.gateway.config>>CaptchaConfig
6.更新所有的Application控制台打印信息
6.数据库的配置
1、运行sql文件
2、更改nacos的配置
表config_info，替换为自己的项目名称，或者直接调到nacos配置，直接从控制台进行修改，一定要替换掉所有包换ruoyi的字段为自己的项目名称，否则会启动不了。
5.nacos的配置
踩坑点：
1.如果是下载的是ruoyi-cloud-v2.4.0以上的版本(目前最新版为v3.0.0)，对应的nacos版本需要>2.0.0(目前最新版本为v2.0.2nacos下载官网) ，不然可能就会一直报类似这种错误>>
新下载的nacos它的application.properties文件里面的鉴权是打开的：### If turn on auth system: nacos.core.auth.enabled=true ，而若依的resources>>bootstrap.yml是没有配置nacos的账号和密码的，所以需要在bootstrap.yml中配置nacos的账户和密码（默认为nacos/nacos）。不然启动Application会报错naocs–403没有鉴权。
启动nacos，windows系统双击，nacos默认是集群版启动，要修改为单机版启动命令
1.Windows下载解压后（.zip），直接点击bin/startup.cmd -m standalone就可以了。 2.Nacos默认是集群模式cluster，可以startup.cmd属性MODE为单机模式standalone
启动后在浏览器中输入(localhost:8848/nacos)就可以访问了，默认的用户名和密码都是nacos
如果没有直接在ry-config数据库中修改content里面的(ruoyi)字段为自己的项目名称，就可以直接在nacos控制台修改所有的配置列表里面的（ruoyi）字段为自己的项目名。特别是Mapper扫描包的路径。
如果要修改顶级pom的<version>1.0.0</version>，则需要修改所有模块下的version版本号，不然回报ClassNotFind的错误。