[精简]RuoYi开发实战-搭建开发环境

简介

RuoYi
使用若依快速构建web应用程序

http://doc.ruoyi.vip/

说明

本文是精简版本，为了方便快速搭建用的。没有详情的介绍。不适宜新手第一次阅读。
需要查看详情的介绍的，可以看
《[图文]RuoYi开发实战-搭建开发环境》
https://blog.csdn.net/lxyoucan/article/details/123764953
B站视频：若依RuoYi开发实战-搭建开发环境
https://www.bilibili.com/video/BV1rZ4y1m7vF/

RuoYi环境准备

JDK

我的详细过程点这里：
《2020macOS Big Sur配置Java开发环境之jdk安装》
https://blog.csdn.net/lxyoucan/article/details/111120215

安装docker

为了方便后面安装mysql和redis我们先来安装一下docker。
首先我们先安装一下docker，详情的帮助见：
《Install Docker Engine on Ubuntu》
https://docs.docker.com/engine/install/ubuntu/

mysql安装

官方文档这样写道：Mysql >= 5.7.0 (推荐5.7版本) ，为了避免踩坑，这里我们就来安装一个5.7版本的吧。

docker安装mysql5.7

#下载镜像
docker pull mysql:5.7.37
#创建mysql实例
docker run --name ruoyi-mysql -p 3306:3306 -e MYSQL\_ROOT\_PASSWORD=itkey123456 -d mysql:5.7.37

连接mysql数据库测试
下面我们来测试一下数据库连接是否正常。

docker run -it --rm mysql:5.7.37 mysql --port=3307 -h172.17.0.1 -uroot -pitkey123456

redis 6.2安装

那我们下载当前最新的稳定版本吧。redis 6.2

#下载镜像
docker pull redis:6.2
#启动一个redis实例
docker run --name ruoyi-redis -p 6379:6379 -d redis:6.2

连接测试

docker run -it  --rm redis:6.2 redis-cli -h 172.17.0.1

下载源码

项目主页：
https://gitee.com/y_project/RuoYi-Vue
把项目克隆到本地即可。

git clone https://gitee.com/y_project/RuoYi-Vue.git

个人比较喜欢使用IDEA作为开发工具。所以使用IDEA打开此项目。使用IDEA直接打开项目根目录下的pom.xml文件即可。比如：/Users/itkey/wisdom/RuoYi-Vue/pom.xml
这样IDEA就可以把它正确的识别了。

数据库初始化

这里我用的是mysql-client 命令行客户端操作的。其他工具也是类似的。

#1. 创建数据库
CREATE DATABASE `ry-vue` CHARACTER SET UTF8;
#2. 选择数据库
use ry-vue;
#3. 设置utf8编码，防止中文乱码
set character_set_client=utf8;
set character_set_connection=utf8;
set character_set_database=utf8;
set character_set_results=utf8;
#导入数据
source /Users/itkey/wisdom/RuoYi-Vue/sql/ry_20210908.sql
source /Users/itkey/wisdom/RuoYi-Vue/sql/quartz.sql

去掉注释的脚本如下：

CREATE DATABASE `ry-vue` CHARACTER SET UTF8;
use ry-vue;
set character_set_client=utf8;
set character_set_connection=utf8;
set character_set_database=utf8;
set character_set_results=utf8;
source /Users/itkey/wisdom/RuoYi-Vue/sql/ry_20210908.sql;
source /Users/itkey/wisdom/RuoYi-Vue/sql/quartz.sql;

Redis配置

修改配置文件RuoYi-Vue/ruoyi-admin/src/main/resources/application.yml

redis:
    # 地址
    host: 172.16.184.13
    # 端口，默认为6379
    port: 6379

以上配置根据实际情况做修改。

数据源配置

修改以下配置文件RuoYi-Vue/ruoyi-admin/src/main/resources/application-druid.yml
把以下内容修改为你的数据库连接。

url: jdbc:mysql://localhost:3306/ry-vue?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
username: root
password: password

Logback报错解决

我是在macOS中启动项目的，所以默认没有/home/ruoyi/logs/这个路径，导致启动报错。

解决办法：
修改配置文件RuoYi-Vue/ruoyi-admin/src/main/resources/logback.xml

把log.path修改成实际保存日志的目录。

修改完成以后，启动项目就成功啦！

测试后端是否启动成功

浏览器访问localhost:8080

如果以上条件都满足了，说明后端启动成功了。下面启动一下前端项目。

前端运行

首先要确保你已经安装了Node.js v12以上版本。
参考文档：http://doc.ruoyi.vip/ruoyi-vue/document/hjbs.html#%E5%89%8D%E7%AB%AF%E8%BF%90%E8%A1%8C

# 进入项目目录
cd ruoyi-ui

# 安装依赖
npm install

# 强烈建议不要用直接使用 cnpm 安装，会有各种诡异的 bug，可以通过重新指定 registry 来解决 npm 安装速度慢的问题。
npm install --registry=https://registry.npmmirror.com

# 本地开发 启动项目
npm run dev

启动成功后

通过浏览器访问日志中显示的地址。

默认用户名:admin
密码：admin123

这样我们的开发环境基本就搭建完成了。