若依框架配置+相关报错
先看需要提前准备的工具,以防看了一半白看了,你也可以先看看大致流程是什么
工具需要:1、IntelliJ IDEA (最好是正式版的,社区版可能有问题)
2、MySQL数据库
3、创建数据库的工具(笔者是用的Navicat,可视化创建比较方便,建议使用可视化创建)
4、Redis下载和配置【Redis】Redis的下载安装和配置-CSDN博客
1、下载若依
1、首先去若依官网,下前后端分离版本的若依,下面为若依官网
若依官网(点击即可进入)
进入页面后,点击下前后端分离版本的若依(页面如下)
点击之后,会跳转到若依的gitee(码云平台)的开源仓库
在下相关资源之前,需要先注册平台账号并且登陆
完成后点击下载,并下载zip压缩包(操作如下)
完成下载后,解压对应的压缩包,然后用IDEA打开该文件夹(把文件夹拖到IDEA快捷方式上就好啦)
打开之后界面如下,(推荐使用正式版的IDEA,社区版可能会出现不可预知的问题)
2、配置数据库+运行sql表
1、首先打开项目列表,找到并打开 application-druid.yml
2、之后找到主数据库部分,我们进行数据库配置,先对其中部分进行解释,方便大家更好的理解,如果你是第一次,跟着我就好啦
-
jdbc:mysql://localhost:3306/ry-vue
中的 “localhost” 是本机地址,如果你的数据库是在本地运行,这个可以不用修改;如果数据库是在远程服务器,需要将 “localhost” 替换为数据库服务器的实际 IP 地址。 -
端口号 “3306” 是 MySQL 的默认端口,若你的数据库使用的是默认端口,则无需修改;若不是,得改成实际的端口号。
-
数据库名称 “ry-vue”,若你之前创建的数据库不是这个名称,例如你创建的是 “ruoyi”,就需要将其改为 “ruoyi”。
3、根据笔者需求决定不修改url的内容,但是没有ry-vue数据库,于是我们先创建一个对应的数据库。(以Navicat为例)
首先右键新建数据库
4、创建名为ry-vue的数据库,字符集选择utf8()
小知识(可以不看): ① 图中的utf8mb3是utf8的全称,
:是 MySQL 中较早使用的 UTF-8 编码字符集,它使用 1 到 3 个字节来表示一个字符,可以表示大多数常用的字符集。但它不支持 Unicode 的全部字符集; ② 选项中还有utf8mb4,utf8mb4是
MySQL 后来引入的完整 UTF-8 编码字符集,它使用 1 到 4 个字节来表示一个字符,支持 Unicode 的全部字符集。
5、我们对数据库进行测试,导入一个数据库表,直接选择若依自带的表,找到我们解压出来的文件夹中,在sql文件夹中,选择当前的sql文件,导入到数据库中。
直接把这个文件拖到Navicat就行,然后点击开始
导入成功
对应的数据库下会出现下面的表,如果没有出现,刷新一下或者断开连接再连接一下就好了。
3、Redis连接
启动Redis客户端。
怎么安装看该链接 【Redis】Redis的下载安装和配置-CSDN博客
4、运行测试
1、找到如下若依测试运行java文件,运行一下试试,由于笔者第一次使用,还没配置JDK,需要配置JDK
点击这里的安装JDK,选择你自己的JDK
2、运行程序,结果出现下面问题,因为笔者是第一次用JAVA套件,之前没有配置过spring-boot相关的东西,所以要再maven中添加spring-boot
3、加载spring-boot(运行成功的可以跳过这个部分)
修改admin下的pro.xml文件
加入如下代码
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter</artifactId></dependency>
之后再次运行
出现这个图标,就运行成功啦!!!!!!阶段性胜利!!!!!!后端完成!!!
5、前端配置
1、打开文件夹的ruoyi-ui
在文件地址框内输入cmd,然后点击回车键,进入命令行
执行npm安装相关依赖(首次需要),然后耐心等待一会儿
npm install --registry=https://registry.npmmirror.com
安装成功
2、修改配置文件(关键步骤)
编辑 ruoyi-ui/.env.development
文件,确保API地址指向你的后端:
# 修改为后端实际地址(默认8080端口)
VUE_APP_BASE_API = 'http://localhost:8080'
可以用记事本打开
保存并退出
6、打开项目
1、和刚才一样 在文件地址框内输入cmd,然后点击回车键,进入命令行
2、 启动前端开发服务器,然后等待加载
npm run dev
3、启动成功后,命令行会显示访问地址:
App running at:- Local: http://localhost:80 - Network: http://192.168.x.x:80
然后会自动打开浏览器,如果没有打开,就访问上面的地址 打开这个也行http://localhost:80
4、登陆系统
使用默认账号登录:
用户名: admin
密码: admin123
成功结果展示
常见问题解决方案
问题1:端口冲突(80端口被占用)
解决方法:修改 ruoyi-ui/vue.config.js
文件:
module.exports = {devServer: {port: 8081, // 改为其他端口,如8081}
}
问题2:接口请求404错误
检查:
-
确保后端在运行(访问 http://localhost:8080 应看到JSON响应)
-
确认
.env.development
中的VUE_APP_BASE_API
配置正确 -
在浏览器开发者工具查看网络请求地址
问题3:无法加载验证码
# 在后端控制台查看日志
[INFO] c.r.framework.web.service.SysLoginService : 用户:admin 登录验证码:8w6g
如果没看到验证码日志,检查:
-
后端
application.yml
中的redis
配置 -
确保Redis服务已启动
问题4:样式错乱/空白页面
# 清理缓存重新构建
cd ruoyi-ui
rm -rf node_modules
yarn cache clean
yarn install
yarn run dev
项目成功运行的标志
-
前端控制台:
DONE Compiled successfully in 4238ms
-
后端控制台:
Started RuoYiApplication in 5.852 seconds (JVM running for 6.452)
-
浏览器访问:
-
看到蓝白配色的登录页面
-
输入账号密码后进入系统首页
-
左侧菜单正常显示(系统管理、系统监控等)
-
下一步操作建议
-
初始化数据库:
-
执行
ruoyi/sql
目录下的SQL脚本 -
特别是
quartz.sql
和ry_2023xxxx.sql
-
-
修改默认密码:
-
登录后进入 "系统管理" → "用户管理"
-
修改admin用户的密码
-
-
验证功能:
-
访问 "系统监控" → "在线用户" 查看当前会话
-
访问 "系统工具" → "代码生成" 测试功能
-
-
生产部署
# 前端构建生产包 yarn run build:prod# 后端打包 cd ruoyi-admin mvn clean package