若依Spring Cloud本地开发部署教程
若依(RuoYi)是一个基于Spring Boot和Spring Cloud的权限管理系统,提供了丰富的功能模块和开箱即用的解决方案。本文将详细介绍如何在本地环境中进行若依Spring Cloud的开发和部署。
一、环境准备
-
Java环境
- 安装JDK 8或更高版本,并配置环境变量
JAVA_HOME
。 - 验证安装:
java -version
- 安装JDK 8或更高版本,并配置环境变量
-
Maven
- 安装Maven 3.5.0或更高版本,并配置环境变量
MAVEN_HOME
。 - 验证安装:
mvn -v
- 安装Maven 3.5.0或更高版本,并配置环境变量
-
Git
- 安装Git客户端,用于克隆项目源码。
-
MySQL
- 安装MySQL数据库,建议使用5.7或8.0版本。
- 创建数据库
ry-cloud
,字符集选择utf8mb4
。
-
开发工具
- 推荐使用IntelliJ IDEA或Eclipse,安装Lombok插件。
二、获取项目源码
-
克隆仓库
git clone https://gitee.com/y_project/RuoYi-Cloud.git
-
分支选择
- 切换到最新稳定分支,例如
v3.8.3
:git checkout v3.8.3
- 切换到最新稳定分支,例如
三、数据库配置
-
执行SQL脚本
- 进入
sql/ry_cloud_xxxx.sql
目录,执行数据库初始化脚本。
- 进入
-
修改配置文件
- 修改
ruoyi-admin/src/main/resources/application.yml
中的数据库连接信息:spring: datasource: url: jdbc:mysql://localhost:3306/ry-cloud?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8 username: root password: your_password
- 修改
四、项目构建与运行
-
Maven构建
cd RuoYi-Cloud mvn clean install -DskipTests
-
启动Nacos
- 若依使用Nacos作为服务发现和配置中心,需先启动Nacos:
cd nacos/bin startup.cmd -m standalone # Windows sh startup.sh -m standalone # Linux/Mac
- 若依使用Nacos作为服务发现和配置中心,需先启动Nacos:
-
启动微服务
- 使用IDEA分别启动以下模块:
ruoyi-auth
:认证中心ruoyi-gateway
:网关服务ruoyi-system
:系统服务ruoyi-gen
:代码生成服务ruoyi-job
:定时任务服务
- 使用IDEA分别启动以下模块:
-
访问Swagger
- 网关启动后,访问:
- 前端:
http://localhost:8080
- Swagger文档:
http://localhost:8080/doc.html
- 前端:
- 网关启动后,访问:
五、本地部署优化
-
配置Redis
- 修改
ruoyi-admin/src/main/resources/application.yml
:spring: redis: host: localhost port: 6379 password: your_redis_password
- 修改
-
配置MinIO
- 若需文件存储功能,配置MinIO:
minio: endpoint: http://localhost:9000 accessKey: minioadmin secretKey: minioadmin bucketName: ruoyi
- 若需文件存储功能,配置MinIO:
-
日志配置
- 在
logback-spring.xml
中调整日志级别和输出路径。
- 在
六、常见问题排查
-
依赖下载失败
- 检查Maven镜像配置,建议使用阿里云镜像。
-
端口冲突
- 修改
application.yml
中的server.port
参数。
- 修改
-
Nacos连接失败
- 确认Nacos是否启动,检查防火墙设置。
-
数据库连接超时
- 检查MySQL服务状态,确认用户名密码正确。
七、总结
通过以上步骤,您已成功完成若依Spring Cloud的本地开发环境搭建。在实际开发中,建议:
- 使用Postman进行接口测试
- 通过Git进行版本控制
- 定期备份数据库
- 关注官方更新日志