微服务启动SpringBoot4

最新版已升级到 Spring Boot 4.1.0 + Spring Cloud Alibaba 2025.1.0.0，必须 JDK17+（支持 17/21/24/25），支持 spring.config.import 方式引入nacos配置

示例：将模块 system、demo ，快速切换成 SpringCloud微服务启动

一、配置host

提醒：必须配置，不然启动会报错。

0.0.1 jeecg-boot-redis
0.0.1 jeecg-boot-mysql
0.0.1 jeecg-boot-nacos
0.0.1 jeecg-boot-gateway
0.0.1 jeecg-boot-system
0.0.1 jeecg-boot-sentinel
0.0.1 jeecg-boot-xxljob
0.0.1 jeecg-boot-rabbitmq

可以使用工具 SwitchHosts 快速配置host.

二、勾选中Maven Profile `dev和SpringCloud`

切换成功效果

注意：dev和SpringCloud 需要同时勾选，不然会出错。

三、创建微服务所需数据库

手工执行 jeecg-boot/db 目录下的初始化SQL脚本，创建以下三个库：

数据库	建表脚本
`jeecg-boot`	`db/jeecgboot-mysql-5.7.sql`
`nacos`	`db/tables_nacos.sql`
`xxl_job`	`db/tables_xxl_job.sql`

⚠️ Nacos 3.x 和 XXL-JOB 3.x 不会自动建表，需手动执行脚本。

重要提示：
1、db/tables_nacos.sql 脚本已包含 jeecg 所需配置，无需额外导入。
2、如果用自己的nacos，请手工添加 jeecg.yaml、jeecg-dev.yaml、jeecg-gateway-dev.yaml 等配置文件

四、启动微服务项目

4.1 启动`nacos`

4.1.1 配置NACOS数据库账号和密码

4.1.2 启动NACOS服务

找到下面的启动类，右键执行

项目：jeecg-server-cloud\jeecg-cloud-nacos
启动类：com.alibaba.nacos.JeecgNacosApplication

访问：http://localhost:18080

账号密码：nacos/nacos

如果需要自定义数据库名字，请参考截图

4.2 启动`jeecg-demo`服务

找到下面的启动类打开注释，右键启动

项目：jeecg-server-cloud/jeecg-demo-cloud-start
启动类：org.jeecg.JeecgDemoCloudApplication

4.3 启动`jeecg-system`服务

1 找到下面的启动类，右键启动

项目：jeecg-server-cloud/jeecg-system-cloud-start
启动类：org.jeecg.JeecgSystemCloudApplication

2 单体启动类可以删掉或者注释掉了

jeecg-system-start/src/main/java/org/jeecg/JeecgSystemApplication.java

4.4 启动网关`gateway`

找到下面的启动类，右键启动

项目：jeecg-server-cloud\jeecg-cloud-gateway
启动类：org.jeecg.JeecgGatewayApplication

所必须服务组件启动效果

访问gateway看接口文档

http://localhost:9999

五、Vue3前端对接 (jeecgboot-vue3)

修改.env.development，配置接口地址为gateway地址: http://localhost:9999

注意：gateway地址是不带/jeecg-boot后缀，否则会报错。

VITE_PROXY = [["/jeecgboot","http://localhost:9999"],["/upload","http://localhost:3300/upload"]]
VITE_GLOB_DOMAIN_URL=http://localhost:9999

启动访问： http://localhost:3100

六、启动更多服务模块

此部分非必须组件，是高级应用。为了降低初学者入门难度，单独放到jeecg-visual目录下，可选择使用。

6.1 Xxljob服务端

1. 先执行脚本 db/tables_xxl_job.sql 创建xxl_job库

2. 修改nacos配置文件，打开xxljob配置

默认是关闭了xxljob，请将nacos中jeecg-dev.yaml中的参数改成true

3. 启动xxljob服务启动

请右键执行 jeecg-cloud-xxljob/com.xxl.job.admin.XxlJobAdminApplication

 项目：jeecg-server-cloud\jeecg-visual\jeecg-cloud-xxljob
 启动类：src\main\java\com\xxl\job\admin\XxlJobAdminApplication.java
  
- 访问：http://localhost:9080/
- 账号：admin/123456

看到了online机器地址有信息说明链接成功了

4. 定时测试

右键执行一次定时

查看日志

查看服务的日志

说明xxljob集成成功

5. 新模块手工集成xxl-job定时任务

6.2 Sentinel服务端

项目：jeecg-server-cloud\jeecg-visual\jeecg-cloud-sentinel
启动类：src\main\java\com\alibaba\csp\sentinel\dashboard\JeecgSentinelApplication.java

-访问：http://localhost:9000
-账号密码：sentinel/sentinel

6.3 Sentinel按需引入（jeecg-boot-starter-sentinel）

⚠️ 新版 Sentinel 已从 starter-cloud 中抽离为独立模块，需要显式引入依赖后才能使用限流熔断功能。

1. 添加依赖

在需要使用 Sentinel 的微服务模块 pom.xml 中添加：

<dependency>
    <groupId>org.jeecgframework.boot3</groupId>
    <artifactId>jeecg-boot-starter-sentinel</artifactId>
</dependency>

2. 开启 Feign Sentinel

spring:
  cloud:
    sentinel:
      transport:
        dashboard: jeecg-boot-sentinel:9000
    openfeign:
      sentinel:
        enabled: true

3. Feign 降级示例

@FeignClient(value = "jeecg-system", fallbackFactory = SysBaseAPIFallbackFactory.class)
public interface ISysBaseAPI {
    // 调用失败时自动走 SysBaseAPIFallbackFactory
}

未配置 fallbackFactory 但返回类型为 Result 时，自动返回 Result.error()。

模块功能：

自动配置 Feign Builder、限流降级处理器、请求来源解析器
限流时返回 HTTP 429 + 统一 JSON 响应
支持 X-Forwarded-For 代理 IP 识别

6.4 SpringBoot Admin服务监控

项目：jeecg-server-cloud\jeecg-visual\jeecg-cloud-monitor
启动类：src\main\java\org\jeecg\monitor\JeecgMonitorApplication.java 

- 访问：http://localhost:9111/login
- 账号：admin/admin

特殊配置

Sentinel已做深度改造，支持持久化配置到nacos中；新版需按需引入 jeecg-boot-starter-sentinel 依赖
微服务做了很多示例，需要请打开jeecg-system-cloud-start项目pom.xml注释
另外测试MQ需要安装rabitmq服务、测试seata也需要安装服务端
更多微服务文档：Sentinel限流熔断降级 | 分库分表文档 | 分布式锁 | 消息总线

其他服务测试地址

软件服务	测试地址	账号密码	是否必须
nacos（服务注册发现和统一配置中心）	http://localhost:18080	nacos/nacos	是
rabitmq （消息中间件）	http://localhost:15672	guest/guest	否
xxl-job-admin（分布式定时任务）	http://localhost:9080	admin/123456	否
sentinel （Sentinel监控）	http://localhost:9000	sentinel/sentinel	否

6.5. rabbitmq服务启动

1、安装rabbitmq

2、修改nacos中jeecg-dev.yaml的rabbitmq链接配置

3、启动system，rabbitmq队列和交换机会自动生成

详细文档见 rabitmq消息队列集成2.4+

一、配置host​

二、勾选中Maven Profile dev和SpringCloud​

三、创建微服务所需数据库​

四、启动微服务项目​

4.1 启动nacos​

4.1.1 配置NACOS数据库账号和密码​

4.1.2 启动NACOS服务​

4.2 启动jeecg-demo服务​

4.3 启动jeecg-system服务​

4.4 启动网关gateway​

五、Vue3前端对接 (jeecgboot-vue3)​

六、启动更多服务模块​

6.1 Xxljob服务端​

1. 先执行脚本 db/tables_xxl_job.sql 创建xxl_job库​

2. 修改nacos配置文件，打开xxljob配置​

3. 启动xxljob服务启动​

4. 定时测试​

5. 新模块手工集成xxl-job定时任务​

6.2 Sentinel服务端​

6.3 Sentinel按需引入（jeecg-boot-starter-sentinel）​

6.4 SpringBoot Admin服务监控​

6.5. rabbitmq服务启动​