作者介绍：本人笔名姑苏老陈，从事JAVA开发工作十多年了，带过大学刚毕业的实习生，也带过技术团队。最近有个朋友的表弟，马上要大学毕业了，想从事JAVA开发工作，但不知道从何处入手。于是，产生了写一个博客专栏想法，介绍当前互联网企业JAVA项目开发如何快速入门。
本文收录于《30天企业JAVA项目开发实战入门》专栏，该专栏内容以当前互联网软件企业中的项目实战为线索，介绍企业JAVA项目开发中涉及到的开发流程、技术、工具、规范要求等等。帮助想从事JAVA开发的大学生或新人，更快的、更好的入门JAVA后端开发工作。
文章目录
- 一、前言
- 二、如何在本地运行若依项目
- 2.1 搭建若依项目开发环境
- 2.2 下载若依项目代码
- 2.3 创建数据库，导入数据脚本
- 2.4 导入代码，运行项目
- 三、总结
一、前言
由于本专栏项目实战学习，是以若依开源项目RuoYi-Cloud为示例。所以，本文介绍如何在本地运行若依项目RuoYi-Cloud；
- 若依项目RuoYi-Cloud简介
若依项目RuoYi-Cloud 是一个 Java EE 企业级的开源免费的快速开发平台，是一个基于Spring Boot、Spring Cloud & Alibaba的微服务的权限管理系统。如果想快速的开发一个Java EE 企业级项目，可以在若依项目的基础上，开发定制自己的项目。尤其是如果要开发一个后台管理系统，由于若依开源项目中已经内置完整的权限管理模块，所以能够更加快速的完成项目的开发工作；
- 若依项目RuoYi-Cloud技术选型
采用前后端分离的模式，微服务版本前端基于 Vue/Element UI ；
后端采用Spring Boot、Spring Cloud & Alibaba微服务架构；
注册中心、配置中心选型Nacos，权限认证使用Redis；
流量控制框架选型Sentinel，分布式事务选型Seata；
- 若依项目官方网站和文档地址
若依官网地址：https://www.ruoyi.vip/
若依演示地址：https://vue.ruoyi.vip/login
技术文档地址：https://doc.ruoyi.vip/ruoyi-cloud/
代码下载地址：https://gitee.com/y_project/RuoYi-Cloud
二、如何在本地运行若依项目
2.1 搭建若依项目开发环境
项目运行环境要求如下：（PS：关于如何搭建开发环境，见本专栏【开发环境搭建篇】介绍）
JDK >= 1.8 (推荐1.8版本)
Mysql >= 5.7.0 (推荐5.7版本)
Redis >= 3.0
Maven >= 3.0
Node >= 12
Nacos >= 2.0.4 (ruoyi-cloud < 3.0 需要下载nacos >= 1.4.x版本)
2.2 下载若依项目代码
开发环境搭建完成后，我们可以去下载码云代码托管平台下载若依RuoYi-Cloud项目的代码。
PS：本专栏使用的代码版本为：RuoYi-Cloud v3.6.3，该版本下载地址为：https://gitee.com/y_project/RuoYi-Cloud/tree/v3.6.3
PS：关于如何从码云gitee下载项目代码，可以查看本栏文章：https://blog.csdn.net/u012171005/article/details/137052350
2.3 创建数据库，导入数据脚本
若依项目代码下载完成后，找到代码目录下面的SQL数据脚本；
之后，创建数据库ry-cloud并导入数据脚本ry_202xxxx.sql（必须），quartz.sql（可选）；
之后，创建数据库ry-config并导入数据脚本ry_config_202xxxx.sql（必须）；
之后，配置Nacos持久化，修改conf/application.properties文件，增加支持mysql数据源配置；
#*************** Config Module Related Configurations ***************#
### If use MySQL as datasource:
### Deprecated configuration property, it is recommended to use `spring.sql.init.platform` replaced.
spring.datasource.platform=mysql
spring.sql.init.platform=mysql
### Count of DB:
db.num=1
### Connect URL of DB:
db.url.0=jdbc:mysql://127.0.0.1:3306/ry-config?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=UTC
db.user.0=您的数据库用户名
db.password.0=您的数据库密码
之后，使用单机模式，启动nacos；
之后，打开nacos控制台界面（PS：nacos控制台地址，见nacos启动时界面输出的信息），检查和修改redis和mysql数据库的配置信息；
配置信息修改完成后，点击发布；
2.4 导入代码，运行项目
之后，打开IDEA开发工具，导入若依RuoYi-Cloud项目的代码；
代码导入后，分别配置JDK、配置Maven；
之后，IDEA会自动下载和导入项目中使用到的依赖jar包；依赖jar包导入完成后，使用Maven编译项目代码；
代码编译通过后，开始依次启动项目的后台服务模块（或者叫XX服务）；
首先启动RuoYiSystemApplication 系统服务，
之后，启动RuoYiGatewayApplication 网关服务；
之后，启动RuoYiAuthApplication 认证服务；
系统服务启动成功，由于该服务配置了swagger，还可以打开swagger地址访问验证；
http://localhost:9201/swagger-ui/index.html
至此，后端项目运行完成。
三、总结
以上，本文介绍了如何在本地运行若依项目RuoYi-Cloud。
期间遇到问题及解决方法，整理如下：
- 问题一：IDEA无法自动导入maven-compiler-plugin.jar包；
错误信息：Cannot resolve plugin org.apache.maven.plugins:maven-compiler-plugin:<unknown>
错误分析：IDEA找不到maven-compiler-plugin.jar包，所以出现该错误。我们需要在项目配置文件中，配置该jar包的版本号信息。
若Maven本地仓库中已经有一个maven-compiler-plugin.jar包；则把该jar包的版本号信息，填写在项目的配置文件中，这样，也不用重新导入了。
若Maven本地仓库中找不到maven-compiler-plugin.jar包，则可以去远程仓库，去查找包的版本号信息，找一个已经发布的jar包版本信息，填写即可。
地址：https://mvnrepository.com/artifact/org.apache.maven.plugins/maven-compiler-plugin
配置maven-compiler-plugin.jar包版本号信息后，如图所示：
如果您对文章中内容有疑问，欢迎在评论区进行留言，我会尽量抽时间给您回复。如果文章对您有帮助，欢迎点赞、收藏。您的点赞，是对我最大的支持和鼓励，谢谢 :-）
