10 分钟上手 RuoYi-Vue-PlusSpring Boot 4 Java 后台脚手架实战指南【免费下载链接】RuoYi-Vue-Plus多租户后台管理系统 重写RuoYi-Vue所有功能 集成 Sa-Token、Mybatis-Plus、WarmFlow、SpringDoc、Hutool、OSS 定期同步项目地址: https://gitcode.com/GitHub_Trending/ru/RuoYi-Vue-PlusRuoYi-Vue-Plus 是一款面向多租户后台管理场景的 Java 快速开发框架基于 Spring Boot 深度整合 Sa-Token、MyBatis-Plus、Redisson、WarmFlow、SpringDoc 等主流组件开箱即用地提供用户、角色、权限、代码生成、工作流等完整功能帮你把 CRUD 和权限体系这部分地基一次打好。RuoYi-Vue-Plus 是一款什么脚手架先说结论它不是一个半成品模板而是一个针对分布式集群场景重写的成熟后端基座——用户、部门、角色、菜单、字典、日志、文件、定时任务、代码生成器这些后台系统绕不开的东西全部内置且按插件化方式拆包用不上的模块直接从 pom 里去掉即可。核心技术选型速览技术领域选用方案说明运行环境JDK 21 Spring Boot 4.1当前版本要求Web 容器Jetty基于 Netty 的高性能容器权限认证Sa-Token JWT支持角色/权限注解校验、多方登录ORMMyBatis-Plus分页、乐观锁、数据权限等插件化缓存Redis Redisson分布式锁、限流、会话同步工作流WarmFlow审批、转办、会签、加减签接口文档SpringDoc基于 Java 注释生成零文档注解工具库Hutool Lombok覆盖日常绝大多数工具需求如何把 RuoYi-Vue-Plus 跑起来1. 准备环境JDK 21、Maven 3.6MySQL 8.x初始化脚本在 script/sql/ 目录ry_vue.sql为核心库Redis密码默认约定为ruoyi123见 dev 配置不想手动装环境的话script/docker/docker-compose.yml 已编排好 MySQL、Redis、Nginx 等全套服务一条命令拉起。2. 拉取并启动git clone https://gitcode.com/GitHub_Trending/ru/RuoYi-Vue-Plus cd RuoYi-Vue-Plus用 IDE 导入根目录 pom.xml先执行mvn install让各模块互相引用成功然后在 ruoyi-admin 模块中找到启动类DromaraApplication直接运行main方法。Maven 默认激活devprofile见根 pom 的activeByDefault对应的就是application-dev.yml。3. 验证启动日志末尾出现 RuoYi-Vue-Plus启动成功 即代表就绪。访问http://localhost:8080后打开http://localhost:8080/plus-doc.htmlSpringDoc 接口文档页能看到按模块分组的 API 列表说明服务已正常工作。默认账号一般是admin/admin123具体以导入的 SQL 初始化数据为准。RuoYi-Vue-Plus 模块职责一览表先看精简目录树抓住主干即可RuoYi-Vue-Plus/ ├── ruoyi-admin/ # 可启动的 Web 入口聚合各模块 ├── ruoyi-api/ # 跨模块共享的接口与 DTO解耦用 ├── ruoyi-common/ # 通用能力家族20 个 common-* 子包 ├── ruoyi-modules/ # 业务模块system、workflow、gen、job、demo... ├── ruoyi-extend/ # 独立部署的扩展服务监控、任务调度 Server └── script/ # SQL 脚本与 Docker 编排各模块定位模块定位关键内容ruoyi-admin启动入口 登录鉴权启动类、认证策略密码/短信/邮件/小程序/社交登录、登录事件监听ruoyi-common框架层的全家桶按能力拆成 20 子包-redis、-satoken、-mybatis、-excel、-oss、-job、-ai等ruoyi-modules/ruoyi-system核心业务用户、角色、菜单、字典、日志等 19 个控制器及配套 service/mapperruoyi-modules/ruoyi-gen代码生成器设计好表结构后一键生成前后端 CRUDruoyi-modules/ruoyi-workflow工作流基于 WarmFlow 的审批流实现ruoyi-api模块间契约跨模块调用的 Service 接口与 DTO避免模块互相引包ruoyi-extend独立服务Spring Boot Admin 监控台、SnailJob 调度 Server、SnailAI Server 一个容易困惑的点老版 RuoYi 有独立的ruoyi-framework模块而 RuoYi-Vue-Plus 把框架层能力打散进了ruoyi-common的各子包。所以你要找的拦截器、Redis 封装、加密组件等都去ruoyi-common下面按子包找而不是找一个 framework 目录。启动入口在做什么整个工程只有一个可运行的入口DromaraApplication.java。贴一下原文代码量极少SpringBootApplication public class DromaraApplication { public static void main(String[] args) { SpringApplication application new SpringApplication(DromaraApplication.class); application.setApplicationStartup(new BufferingApplicationStartup(2048)); application.run(args); System.out.println((♥◠‿◠) RuoYi-Vue-Plus启动成功 ლ(´ڡლ)); } }别看它只有 5 行run(args)一调用背后替读者干完了一整套事组件扫描SpringBootApplication会扫描org.dromara包下所有Controller、Service等 Bean所以ruoyi-modules里各业务模块的类能被自动装配进来无需手工注册自动配置依据各 common 包提供的spring.factories/自动配置类把 Sa-Token 认证、MyBatis-Plus 拦截器、Redis 序列化等能力静默装进容器——这也是插件化解耦的体现加载环境配置按 Maven profile 加载application-dev.yml等环境文件完成数据源、Redis 的初始化BufferingApplicationStartup(2048)则是记录启动过程最近 2048 个事件的缓冲器供 Spring Boot Admin 做启动耗时分析与业务无关可无视。RuoYi-Vue-Plus 关键配置项速查配置分两层application.yml 放所有环境通用的设置application-dev.yml/application-prod.yml放环境相关的设置数据库地址、Redis 地址等。最常要动的几项配置项位置默认值作用何时需要改server.portapplication.yml8080应用 HTTP 端口端口冲突或与前端代理不符时spring.profiles.activeapplication.yml由 Maven profile 注入默认 dev决定加载哪份环境配置打包 prod 时由-Pprod切换spring.datasource.dynamic.datasource.master.*application-dev.ymlMySQLlocalhost:3306/ry-vue账号 root/root主数据源基于 dynamic-datasource 支持异构多库本地启动必改改成你自己的库地址与账号spring.data.redis.*application-dev.ymllocalhost:6379密码ruoyi123Redis 连接本地 Redis 密码不同或部署到远程时sa-token.token-name/jwt-secret-keyapplication.ymlAuthorization/ 示例密钥登录态 Token 名称与 JWT 签名密钥生产环境务必更换密钥mybatis-plus.mapperPackageapplication.ymlorg.dromara.**.mapperMapper 接口扫描范围新增业务模块改了包结构时springdoc.group-configsapplication.yml按包名分 5 组接口文档分组新增业务模块想单独成组时⚠️ 两个高频坑一是api-decrypt配置里的接口加解密密钥默认是示例值生产前需生成替换二是 Redis 配置里单机与集群二选一切换时注意注释掉另一段否则会以后加载者为准。下一步建议与常见坑接下来干什么打开ruoyi-modules/ruoyi-demo里面有 Excel、加密、分布式锁、限流、MQTT 等真实可运行的功能案例是理解各 common 包用法的最佳入口用ruoyi-gen代码生成器建一张表试试一键出 CRUD感受降 80% 重复代码的卖点需要改包名/模块名时参考 README 中的项目路径修改方案不要硬改。常见坑提示启动报数据源连接失败99% 是没导入 SQL 或application-dev.yml里数据库账号不对登录失败确认 Redis 正常Sa-Token 会话依赖 Redis且ry_vue.sql中的初始用户数据已导入本地能跑、打包后行为不同检查 Maven profileprodprofile 会切换logging.level为warn并加载application-prod.yml。从跑通到读懂结构只需十分钟入口在ruoyi-admin能力在ruoyi-common业务在ruoyi-modules改配置优先动application-dev.yml。抓住这四条线这个脚手架就再不会陌生。【免费下载链接】RuoYi-Vue-Plus多租户后台管理系统 重写RuoYi-Vue所有功能 集成 Sa-Token、Mybatis-Plus、WarmFlow、SpringDoc、Hutool、OSS 定期同步项目地址: https://gitcode.com/GitHub_Trending/ru/RuoYi-Vue-Plus创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考