---

前言

由于最近公司项目的整合，项目准备从Spring Boot-Vue的单体应用转向微服务架构,于是选用了免费开源的基于Spring Boot、Spring Cloud & Alibaba的分布式微服务架构权限管理系统的RuoYI-Cloud来作为脚手架，进行二次开发，下面就项目从下载到改为自己的项目的全过程遇到的坑点到成功运行给大家做个参考，如有错误，望指正。

---

一、下载RuoYi-Cloud后端项目

下载地址：https://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

1. com.syw.common.security.annotation>>EnableRyFeignClients
2. com.syw.gateway.config>>CaptchaConfig
3. 更新所有的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下载官网) ，不然可能就会一直报类似这种错误>>

2. 新下载的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没有鉴权。
   
   
3. 启动nacos，windows系统双击，nacos默认是集群版启动，要修改为单机版启动命令
   1.Windows下载解压后（.zip），直接点击bin/startup.cmd -m standalone就可以了。 2.Nacos默认是集群模式cluster，可以startup.cmd属性MODE为单机模式standalone
   
4. 启动后在浏览器中输入(http://localhost:8848/nacos)就可以访问了，默认的用户名和密码都是nacos
5. 如果没有直接在ry-config数据库中修改content里面的(ruoyi)字段为自己的项目名称，就可以直接在nacos控制台修改所有的配置列表里面的（ruoyi）字段为自己的项目名。特别是Mapper扫描包的路径。
   
6. 如果要修改顶级pom的<version>1.0.0</version>，则需要修改所有模块下的version版本号，不然回报ClassNotFind的错误。
   

6. 项目成功运行起来

撒花，完结。
仅仅是自己搭建项目中遇见的一些踩坑点，和一些探究，不喜勿喷。

---

总结

大多数人过着他人的生活，他们的思想是他人的观点，
他们的生活是对他人的模仿，他们的热情是一句引言。