快速启动（后端项目）

## 1. 克隆代码
使用 IDEA 克隆 dtpc仓库的最新代码，并给该仓库一个 Star。
注意：不建议使用 Eclipse，因为它没有支持 Lombok 和 Mapstruct 插件。

克隆完成后，耐心等待 Maven 下载完相关的依赖。一定要注意：

① 默认情况下，使用 master 分支，它对应 JDK 8 + Spring Boot 2.7 版本。

② 如果你想体验 JDK 17/21 + Spring Boot 3.2 版本，需要切换到 master-jdk17 分支。

友情提示：项目的每个模块的作用，可见 《开发指南 —— 项目结构》 文档。

使用的 Spring Cloud 版本较新，所以需要下载一段时间。趁着这个时间，胖友可以给项目添加一个 Star ，支持下艿艿。
## 2. Apifox 接口工具
点击 Apifox 首页，下载对应的 Apifox 桌面版。如下图所示：

![](/media/202408/2024-08-23_155925_271910.png)
解压后，双击进行安装即可。黑色界面，非常酷炫。

![](/media/202408/2024-08-23_160132_763754.png)
## 3. 基础设施（必选)
本小节的基础设施【必须】安装，否则项目无法启动。
#### 3.1 初始化 MySQL
友情提示？

如果你是 PostgreSQL、Oracle、SQL Server、DM、大金 等其它数据库，也是可以的。

因为我主要使用 MySQL数据库为主，所以其它数据库的 SQL 文件可能存在滞后，可以加入 用户群 反馈。
项目使用 MySQL 存储数据，所以需要启动一个 MySQL 服务。

① 创建一个名字为 ruoyi-vue-pro 数据库，【只要】 执行对应数据库类型的 sql 目录下的 ruoyi-vue-pro.sql SQL 文件，进行初始化。

![](/media/202408/2024-08-23_160427_446754.png)
② 默认配置下，MySQL 需要启动在 3306 端口，并且账号是 root，密码是 123456。如果不一致，需要修改 application-local.yaml 配置文件。

![](/media/202408/2024-08-23_160457_116244.png)
如果是 MySQL 数据库，不需要看 ③、④ 两点！！！

③ 【如果是 PostgreSQL、Oracle、SQL Server 数据库】

![](/media/202408/2024-08-23_160516_851187.png)

注意，需要使用 IDEA 刷新下 Maven 的依赖。

④ 【如果是 DM 达梦数据库】建议先使用 MySQL 跑通，然后再阅读 《达梦数据库专属》 文档。

⑤ 【如果是大金数据库】建议先使用 MySQL 跑通，然后使用 PostgreSQL 驱动进行连接。

#### #3.2 初始化 Redis
项目使用 Redis 缓存数据，所以需要启动一个 Redis 服务。
不会安装的胖友，可以选择阅读下文，良心的艿艿。

Windows 安装 Redis 指南：http://www.iocoder.cn/Redis/windows-install
Mac 安装 Redis 指南：http://www.iocoder.cn/Redis/mac-install
默认配置下，Redis 启动在 6379 端口，不设置账号密码。如果不一致，需要修改 application-local.yaml 配置文件。

![](/media/202408/2024-08-23_160801_344757.png)
#### 3.3 初始化 Nacos
项目使用 Nacos 作为注册中心和配置中心
安装完成之后，需要创建 dev 命名空间，如下图所示：

![](/media/202408/2024-08-23_160926_150237.png)
注意！新建命名空间时，它的“命名空间ID”、“命名空间名”都要是 dev 噢！！！
## 4. 基础设施（可选）
本小节的基础设施【可选】安装，不影响项目的启动，可在项目启动后再安装。

如果你想使用 Docker 一键搭建 RocketMQ、XXL-Job 等相关环境，可阅读 https://t.zsxq.com/g9nsF 子。
#### 4.1 RocketMQ
项目使用 RocketMQ 作为消息中心和事件总线
#### 4.2 XXL-Job
① 项目使用 XXL-Job 作为定时任务
② 默认配置下，本地 local 环境的定时任务是关闭的，避免控制台一直报错报错。如果要开启，请参考 《微服务手册 —— 定时任务》 文档。

## 5. 启动后端项目
#### 5.1 编译项目
第一步，使用 IDEA 自带的 Maven 插件，进行项目的编译。如下图所示：

![](/media/202408/2024-08-23_161345_935207.png)
【可选】也可以使用 Maven 命令编译：

使用 IDEA 打开 Terminal 终端，在 根目录 下直接执行 mvn clean install package '-</span>Dmaven.test.skip=true' 命令。
如果执行报 Unknown lifecycle phase “.test.skip=true” 错误，使用 mvn clean install package -Dmaven.test.skip=true 即可。
ps：只有首次需要执行 Maven 命令，解决基础 pom.xml 不存在，导致报 BaseDbUnitTest 类不存在的问题。

整个过程，预计需要 1 分钟左右。成功后，控制台日志如下：
> [INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 9.139 s (Wall Clock)
[INFO] Finished at: 2024-05-03T18:56:03+08:00
[INFO] ------------------------------------------------------------------------
## 
5.2 启动 gateway 服务
执行 GatewayServerApplication 类，进行启动。

启动还是报类不存在？
可能是 IDEA 的 bug，点击 [File -> Invalidate Caches] 菜单，清空下缓存，重启后在试试看。

![](/media/202408/2024-08-23_161716_754459.png)

启动完成后，使用浏览器访问 http://127.0.0.1:48080地址，返回如下 JSON 字符串，说明成功。
友情提示：注意，默认配置下，网关启动在 48080 端口。

{"code":404,"data":null,"msg":null}

## 5.3 启动 system 服务
执行 SystemServerApplication 类，进行启动。

![](/media/202408/2024-08-23_161833_334031.png)

启动完成后地址，都返回如下 JSON 字符串，说明成功。
{"code":401,"data":null,"msg":"账号未登录"}

## 5.3 启动 infra 服务
执行 InfraServerApplication 类，进行启动。

![](/media/202408/2024-08-23_162107_648671.png)
启动完成后 JSON 字符串，说明成功。
5.4 启动 bpm 服务
参见 《工作流手册》 文档。

#5.5 启动 report 服务
参见 《大屏手册》 文档。

#5.6 启动 pay 服务
参见 《支付手册》 文档。

#5.7 启动 mp 服务
参见 《公众号手册》 文档。

#5.8 启动 mall 服务
参见 《商城手册》 文档。

#5.9 启动 erp 服务
参见 《ERP 手册》 文档。

#5.10 启动 crm 服务
参见 《CRM 手册》 文档。

#5.11 启动 ai 服务
参见 《AI 大模型手册》 文档。

## 6. 启动前端项目【简易】

![](/media/202408/2024-08-23_162308_048204.png)