基于若依搭建微服务nacos版本（ruoyi

基于若依搭建微服务nacos版本（ruoyi

说明：本文介绍基于Ruoyi-Cloud前后端分离nacos版本的微服务从0到1的搭建过程，同时新增一个新的微服务模块。是基于官方文档的补充说明，需要结合Ruoyi-Cloud的官方文档 /ruoyi-cloud/
如果直接查看官方文档便可成功部署，推荐直接看官方文档。
以下，我将从自己搭建安装过程中，遇到的坑和bug做详细补充说明，主要涵盖以下几个方面：
1、前置环境搭建（重要）：主要包含nacos、redis。
2、运行系统：主要包含前后端运行，以及运行过程中的关键确认点。

1 环境准备

建议下列组件安装在自己的本机上，或者安装在 可以和你的主机相互访问 的另一台服务器上，这样初次部署可以规避很多网络访问的坑。

JDK >= 1.8 (推荐1.8版本) # 独自安装即可
Mysql >= 5.7.0 (推荐5.7版本) # 独自安装即可
Redis >= 3.0 # 可以docker安装，参看
Maven >= 3.0 # 独自安装接口
Node >= 12 # 独自安装即可
nacos >= 2.0.4 (ruoyi-cloud < 3.0 需要下载nacos >= 1.4.x版本) # docker安装

nacos的安装，可以参考我的另一个文章：docker安装nacos

2 运行系统

安装官方的操作进行代码下载和数据库配置

1、前往Gitee下载页面( (opens new window))下载解压到工作目录
2、导入到Eclipse，菜单 File -> Import，然后选择 Maven -> Existing Maven Projects，点击 Next> 按钮，选择工作目录，然后点击 Finish 按钮，即可成功导入。
Eclipse会自动加载Maven依赖包，初次加载会比较慢（根据自身网络情况而定）
3、创建数据库ry-cloud并导入数据脚本ry_2021xxxx.sql（必须），quartz.sql（可选）
4、创建数据库ry-config并导入数据脚本ry_config_2021xxxx.sql（必须）
5、配置nacos持久化，修改conf/application.properties文件，增加支持mysql数据源配置 # 在上文的docker安装nacos中，进行数据库配置。

需要注意的是，当我们吧ry-config数据导入完成后，请重启nacos，并登录nacos控制台，理论上是可以看到该界面的：
如果没有看到该界面，请查看你的

• nacos是否有问题，有没有同时打开8848 9848 9849这三个端口
• 是否存在网络问题：确保你的nacos所在服务器能够访问你在nacos配置文件中配置的数据库
• 数据库配置是否错误：确保在fig_info表中配置的content数据连接内容（mysql、redis等），是可以被你的微服务直接访问的
  

2.1 后端运行

打开运行基础模块（启动没有先后顺序）
RuoYiGatewayApplication （网关模块 必须）
RuoYiAuthApplication （认证模块 必须）
RuoYiSystemApplication （系统模块 必须）
RuoYiMonitorApplication （监控中心 可选）
RuoYiGenApplication （代码生成 可选）
RuoYiJobApplication （定时任务 可选）
RuoYFileApplication （文件服务 可选）

2.2 前端运行

进入项目目录
cd ruoyi-ui
强烈建议不要用直接使用 cnpm 安装，会有各种诡异的 bug，可以通过重新指定 registry 来解决 npm 安装速度慢的问题。
npm install --registry=
本地开发 启动项目
npm run dev
4、打开浏览器，输入：(localhost:80 (opens new window)) 默认账户/密码 admin/admin123）
若能正确展示登录页面，并能成功登录，菜单及页面展示正常，则表明环境搭建成功

3 新建一个微服务module：ruoyi-jxbd

通过前两步骤，我们已经完成ruoyi-Cloud的启动，接下来我们需要做的基于该框架额外搭建一个微服务module，module名称就叫做：jxbd（不用问我为什么叫这个，随便起的）。

3.1 使用postman调用接口

做开发的第一步是模仿ruoyi的接口实现方式，首先我们要能使用postman调用若依的接口。
登录进ruoyi控制台，打开F12，然后刷新页面。可以看到一些请求接口，这里我们选择getInfo接口，如下图：
我们需要的三个信息：

• 请求url：localhost/dev-api/system/user/getInfo
• 请求方式：GET
• 鉴权：Authorization
  
  打开postman，并配置上述信息，发送请求即可，如下：
  

3.2 模仿ruoyi-system模块，新建一个ruoyi-jxbd模块

先放截图：

基于ruoyi搭建一个新的module需要做的事情有如下几个方面：

• 1、新增上图所述的目录结构和代码
• 2、修改主pom文件，增加新模块
• 3、在fig_info表中，新增一条记录，该记录用于新服务注册到nacos。
• 4、启动新模块

3.2.1 新建ruoyi-jxbd模块

这个模块的创建，我是参考ruoyi-modules ruoyi-system进行创建的。学习的第一步，像素级复刻，开始！

完整的目录树，见上上图。需要重点关注的文件有：
文件：该文件是参考system下面的pom修改的，需要修改的已在下文标注

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns:xsi=""xmlns=".0.0"xsi:schemaLocation=".0.0 .0.0.xsd"><parent><groupId>com.ruoyi</groupId><artifactId>ruoyi</artifactId><version>3.6.3</version></parent><modelVersion>4.0.0</modelVersion><!-- 修改为自己的名字 --><artifactId>ruoyi-jxbd</artifactId><description><!-- 修改为自己的名字 -->ruoyi-jxbd系统模块</description><dependencies><!-- SpringCloud Alibaba Nacos --><dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId></dependency><!-- SpringCloud Alibaba Nacos Config --><dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId></dependency><!-- SpringCloud Alibaba Sentinel --><dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-sentinel</artifactId></dependency><!-- SpringBoot Actuator --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-actuator</artifactId></dependency><!-- Swagger UI --><dependency><groupId>io.springfox</groupId><artifactId>springfox-swagger-ui</artifactId><version>${swagger.fox.version}</version></dependency><!-- Mysql Connector --><dependency><groupId&sql</groupId><artifactId>mysql-connector-j</artifactId></dependency><!-- RuoYi Common DataSource --><dependency><groupId>com.ruoyi</groupId><artifactId>ruoyi-common-datasource</artifactId></dependency><!-- RuoYi Common DataScope --><dependency><groupId>com.ruoyi</groupId><artifactId>ruoyi-common-datascope</artifactId></dependency><!-- RuoYi Common Log --><dependency><groupId>com.ruoyi</groupId><artifactId>ruoyi-common-log</artifactId></dependency><!-- RuoYi Common Swagger --><dependency><groupId>com.ruoyi</groupId><artifactId>ruoyi-common-swagger</artifactId></dependency></dependencies><build><finalName>${project.artifactId}</finalName><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId><executions><execution><goals><goal>repackage</goal></goals></execution></executions></plugin></plugins></build></project>

文件，需要注意的点：

• 1、port，要注意不要和系统已占用的端口、若依的其他模块端口冲突，可以在ReadMe.md中查看ruoyi配置的默认端口。
• 2、应用名称，修改为ruoyi-jxbd

# Tomcat
server:port: 9888# Spring
spring: application:# 应用名称name: ruoyi-jxbdprofiles:# 环境配置active: devcloud:nacos:discovery:# 服务注册地址server-addr: 127.0.0.1:8848config:# 配置中心地址server-addr: 127.0.0.1:8848# 配置文件格式file-extension: yml# 共享配置shared-configs:- application-${spring.profiles.active}.${spring.fig.file-extension}

其余代码，像素级复刻SysConfigController的具体实现逻辑即可。

3.2.2 修改主pom文件

添加ruoyi-jxbd模块

3.2.3 新增nacos配置

在fig_info表中，新增一条记录：
该记录也是借鉴system模块修改的，主要关注的点：

• 1、redis和mysql配置
• 2、mybatis的包名称

INSERT INTO `ry-config`.config_info (id, data_id, group_id, content, md5, gmt_create, gmt_modified, src_user, src_ip, app_name, tenant_id, c_desc, c_use, effect, type, c_schema, encrypted_data_key) VALUES (10, &#l', 'DEFAULT_GROUP', '# spring配置
spring:redis:host: 192.168.10.15port: 6379password:datasource:druid:stat-view-servlet:enabled: trueloginUsername: adminloginPassword: 123456dynamic:druid:initial-size: 5min-idle: 5maxActive: 20maxWait: 60000connectTimeout: 30000socketTimeout: 60000timeBetweenEvictionRunsMillis: 60000minEvictableIdleTimeMillis: 300000validationQuery: SELECT 1 FROM DUALtestWhileIdle: truetestOnBorrow: falsetestOnReturn: falsepoolPreparedStatements: truemaxPoolPreparedStatementPerConnectionSize: 20filters: stat,slf4jconnectionProperties: Sql\=true;druid.stat.slowSqlMillis\=5000datasource:# 主库数据源master:driver-class-name: sql.cj.jdbc.Driverurl: jdbc:mysql://xxxx:3306/database?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8username: rootpassword: xxxx# 从库数据源# slave:# username: # password: # url: # driver-class-name: # mybatis配置
mybatis:# 搜索指定包别名typeAliasesPackage: com.ruoyi.jxbd# 配置mapper的扫描，找到所有的l映射文件mapperLocations: classpath:mapper/**/*.xml# swagger配置
swagger:title: 系统模块接口文档license: Powered By ruoyilicenseUrl: ', '00678c89684ec0b825cb9b71e032db65', '2020-11-20 00:00:00', '2023-12-04 07:51:28', 'nacos', '0:0:0:0:0:0:0:1', '', '', '数据模块', 'null', 'null', 'yaml', '', '');

3.2.3 启动新的微服务模块

• 1、重新编译整个代码工程
• 2、重启nacos，确保nacos中有ruoyi-jxbd的配置
• 3、启动gateway、auth、system、jxbd模块
  postman调用接口，即可，至此完工。

参考资料：
RuoYi-Cloud介绍 ：/ruoyi-cloud/
Ruoyi-Cloud讨论：