RuoYi-Vue-Plus 多租户管理系统实战如何快速搭起一套企业级后端底座【免费下载链接】RuoYi-Vue-Plus多租户后台管理系统 重写RuoYi-Vue所有功能 集成 Sa-Token、Mybatis-Plus、WarmFlow、SpringDoc、Hutool、OSS 定期同步项目地址: https://gitcode.com/GitHub_Trending/ru/RuoYi-Vue-PlusRuoYi-Vue-Plus 是基于 Spring Boot 3 Vue 3 的多租户后台管理系统把租户隔离、认证授权、缓存锁、定时任务等通用能力做成了可插拔模块让你跳过重复造轮子直接把精力花在业务上。它适合谁先不看技术细节先看三类最典型的处境你属于哪一种从 0 到 1 做 SaaS 的团队你要给多家客户提供同一个后台但每家客户的数据绝不能互相看见。自己搭一套注册租户—分配菜单权限—按租户隔离数据的链路没两三个月下不来用现成框架可以把这部分压缩到按周计。想给老系统加租户能力的开发者系统已经跑得不错只是要支持按租户卖。RuoYi-Vue-Plus 的租户过滤在 SQL 层完成业务代码不用感知改造成本比每个查询手写 where 条件低很多。需要审批流的中小企业请假、报销、用章这类流程如果每次找第三方系统集成成本高。项目内置 WarmFlow 工作流引擎转办、会签、加签这些常见动作开箱可用模块在 ruoyi-modules/ruoyi-workflow/。反过来如果你只是写个纯内部脚本或单机小工具它的功能密度就是负担下文会再提边界。架构一眼看 整体思路是微内核 插件核心启动器很薄能力被拆成一个一个独立 Maven 模块每个模块自带自动配置引就生效、不引就不占地方。大致分四层层次目录里面装什么基础层ruoyi-common/ruoyi-common-core/通用工具、统一返回体、异常、常量所有模块的地基功能层ruoyi-common/ 下的 ruoyi-common-*mybatis、redis、satoken、oss、excel、sms、encrypt 等 20 来个能力模块各管一摊业务层ruoyi-modules/用户权限system、代码生成gen、工作流workflow、演示demo等可裁剪的业务包扩展层ruoyi-extend/独立进程监控台、SnailJob 调度服务、SnailAI 服务可单独部署这种划分带来的直接好处是只想要登录 权限 租户的最小系统就引基础层加两三个功能层模块不用背全量依赖。关键机制拆解下面挑三个最常被问到的机制每个按怎么工作 → 什么时候用 → 怎么配讲。业务代码为什么看不到租户字段怎么工作隔离逻辑挂在 MyBatis-Plus 的TenantLineInnerInterceptor插件上。请求进来时租户号已经确定插件在 SQL 执行前自动改写语句给每张业务表补上tenant_id 当前租户的过滤条件。可以类比成小区门禁物业拦截器在每道门每张表自动核对你住的楼栋号租户号住户自己业务代码根本不用掏门禁卡。个别全局共享的表如菜单、租户表会被排除在过滤之外。什么时候用多客户共用一套库时默认就该开单租户内部系统可以不开。行级隔离适合数据量大、租户多、单租户体量小的典型 SaaS 形态对隔离要求极苛刻的少数大客户建议单独评估库级或 schema 级方案。怎么配功能集中在 ruoyi-common/ruoyi-common-mybatis/开关与排除表清单在配置文件里声明例如tenant: enable: true # 全局开关 excludes: # 不参与租户过滤的公共表 - sys_menu - sys_tenant登录方式为什么能一次配置全都有怎么工作认证框架是 Sa-Token一个比 Spring Security 配置轻得多的登录鉴权库会话、踢人、权限判断都走它。项目把不同登录方式做成了并列的策略实现密码、短信、邮箱、小程序、社交三方见 ruoyi-admin 的 service/impl/前端传什么登录类型就路由到哪个策略互不干扰。什么时候用普通后台密码登录是默认项面向 C 端或办公场景时短信/社交登录按需开启即可策略之间可共存。怎么配核心项在 ruoyi-common/ruoyi-common-satoken/ 的配置里常用几项sa-token: token-name: Authorization # 请求头里带 token 的字段名 is-concurrent: true # 允许同一账号多处同时登录 is-share: false # 每次登录独立生成 token注意项目默认关闭了从 Cookie 读 tokenis-read-cookie: false从源头减少 CSRF 面。缓存和锁是怎么做到多租户不打架的怎么工作客户端用 Redisson功能比原生 Lettuce 多的 Redis 客户端单机、哨兵、集群三种部署形态都能接。多租户场景下缓存 key 会经过前缀处理器给不同租户的数据加上不同抽屉编号避免 A 租户读到 B 租户的缓存。分布式锁基于 Lock4j 实现防重复提交则是RepeatSubmit注解 切面把短时间内的重复请求挡在 Redis 里类似快递柜扫码取件第二个人扫同一个码直接提示已取走。什么时候用只要你的系统部署超过一个实例session 共享、验证码、限流、锁就都得落到 Redis 上扣库存、发券这类多实例抢资源的操作建议加锁并把锁粒度控制在单个业务对象级别别锁整张表。怎么配Redisson 连接方式按部署形态切换开发环境单机即可redisson: config: singleServerConfig: # 单机模式哨兵/集群换对应配置段 address: redis://127.0.0.1:6379这组技术选型为什么这么定组件本项目选择常见替代选择理由Web 容器UndertowTomcat非阻塞 IO 模型同等压力下内存占用更低适合长连接多的后台权限框架Sa-TokenSpring Security配置量小得多踢人、并发登录等高频需求是现成 APIORMMyBatis-Plus原生 MyBatis分页、乐观锁、租户过滤以插件形式提供少写大量模板 SQL任务调度SnailJobQuartz调度数据放 Redis实例之间天然分片不用自己维护调度表锁对象存储MinIO服务器本地盘分布式部署时本地盘无法共享MinIO 兼容 S3 协议可平滑换云存储选型没有绝对的对错但容器轻一点、配置声明化、能分布式就不依赖单节点是这套组合共同的取向。性能调优旋钮不拆成三章就给你一张作用 起步值清单上线后按监控数据微调HikariCP 连接池替代 Druid更轻更快作用是把数据库连接池化复用避免每次查询建连接。起步参考maximum-pool-size: 20、minimum-idle: 5、connection-timeout: 30000。池子开太大并不好经验法则是每核 2~4 条连接 少量余量。Undertow 线程作用是对接 HTTP 请求IO 线程负责收发、worker 线程处理业务。起步参考buffer-size: 512、direct-buffers: true、io: 8、worker: 2564 核机器可各减半试。p6spy SQL 监控作用是打印带参数和执行耗时的完整 SQL定位慢语句时比开 debug 日志干净得多。它吃 CPU 和 IO只在开发/排障环境开生产环境关掉。部署与日常运维 项目自带 script/docker/docker-compose.yml一条docker compose up -d拉起全家桶MySQL 8.4、Redis 8、MinIO、Nginx以及后端主服务compose 里起了 ruoyi-server1 / ruoyi-server2 两个实例正好验证分布式行为、监控台、SnailJob 与 SnailAI 服务。数据库初始化脚本按方言分好了目录MySQL 版在 script/sql/ry_vue.sql另备有 Oracle / SQL Server / PostgreSQL 版本。监控方面ruoyi-extend/ruoyi-monitor-admin/ 是一个独立的 Spring Boot Admin 服务主应用作为客户端注册进去之后可以看到实例存活、JVM 指标、健康端点出问题先盯这里比翻日志快。日常运维的两个提醒Redis 是锁、缓存、调度的共同底座生产环境建议至少哨兵模式起步两个主服务实例之间没有内置负载均衡前置 Nginx 或云 LB 做分发即可注意 token 走请求头天然无状态友好。到底要不要用它比较适合多客户 SaaS 后台、需要审批流的内部管理端、想快速验证业务可行性的中型项目。它的模块化意味着你可以只拿最小内核起步边长边加模块。不太适合纯微服务架构它本质是一个模块化单体服务拆分要自己规划、对技术栈有强制指定的团队比如公司只允许 Spring Security、数据量巨大需要一开始就做分库分表的场景——它的多租户默认是行级隔离库级拆分属于要动手术的部分。边界条件Spring Boot 版本、JDK 版本21/25 均支持升级时多数问题出在功能层第三方 starter 上建议先在 ruoyi-common-bom/ 统一升版本再逐模块回归而不是零散改。债务与演进作为活跃维护的开源项目第三方依赖更新、静态扫描接入、文档随代码同步这三件事建议纳入团队常规动作而不是攒着。往云原生方向走K8s 编排、服务网格时compose 里每个服务本来就是独立镜像平迁成本不高AI 能力ruoyi-ai 模块 SnailAI 服务目前是加分项而非必选项按业务需要再接。结尾把底座换掉的风险永远比把底座搭好的成本低——先用它跑通最小业务再决定留哪些模块。仓库里 ruoyi-demo/ 的演示接口是最好的入门材料。建议先拉一个租户 一个工作流流程跑起来手感比文档来得快。【免费下载链接】RuoYi-Vue-Plus多租户后台管理系统 重写RuoYi-Vue所有功能 集成 Sa-Token、Mybatis-Plus、WarmFlow、SpringDoc、Hutool、OSS 定期同步项目地址: https://gitcode.com/GitHub_Trending/ru/RuoYi-Vue-Plus创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考