# 【RuoYi-SpringBoot3-Pro】：多租户功能上手指南

做 SaaS 系统最头疼的是什么？肯定是**数据隔离**。

**[RuoYi-SpringBoot3-Pro](https://github.com/undsky/RuoYi-SpringBoot3-Pro)** 直接集成了 MyBatis-Plus 的多租户插件（TenantLineInnerInterceptor），不用再关注租户 ID，框架层自动给你注入过滤条件。配合 [使用 Dify + AI 快速生成多数据库建表语句](https://mp.weixin.qq.com/s?__biz=MzAwOTExOTc1MQ==&mid=2247484067&idx=1&sn=cfa89e55f04b1336164b63493d3f5cb1&chksm=9b6533cbac12badd7f30e84570fec61df1b3a90ffa71432b6c327d7888c199122c9b4bd3f649&scene=178&cur_album_id=4260128209435361290&search_click_id=#rd)，使开发效率直线提升！

## 开启配置

多租户功能默认是关闭的。在 `ruoyi-admin` 下面的 `application.yml` 里找 `tenant` 配置：

```yaml
tenant:
  enable: true # 把它改成 true，多租户就生效了
  column: tenant_id # 你的表里用来区分租户的字段名，一般都叫 tenant_id
  filterTables: # 这里的表，会强制进行 SQL 过滤
  ignoreTables: # 这些表是不进行租户隔离的
    - sys_user # 用户表
    - sys_role # 角色表
    - sys_menu # 菜单表
    - sys_dept # 部门表
    - sys_dict_data # 字典数据
    # ... 省略其它系统表
  ignoreLoginNames: # 超级管理员，让他能看所有租户的数据
    - admin
```
由于 `RuoYi-SpringBoot3-Pro` 是在 `RuoYi-Vue3` 基础上的增强版，本着**只做增强，不做改变** 的原则，原来系统的表只在 `sys_user` 中添加了 `tenant_id`。有需要的小伙伴需要自行扩展。


## 实现代码

就像开头所说，其实实现特别简单，就是用 MyBatis-Plus 的拦截器。

在 `ruoyi-framework/src/main/java/com/ruoyi/framework/config/MybatisPlusConfig.java`，中设置：

```java
@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor(TenantProperties tenantProperties) {
    MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
    if (Boolean.TRUE.equals(tenantProperties.getEnable())) {
        // 启用多租户插件拦截
        interceptor.addInnerInterceptor(new TenantLineInnerInterceptor(new MultiTenantHandler(tenantProperties)));
    }
    // ...
    return interceptor;
}
```

它注册了一个 `TenantLineInnerInterceptor`，并传入了一个 `MultiTenantHandler`。这个 Handler 位于 `ruoyi-framework/src/main/java/com/ruoyi/framework/config/MybatisPlusConfig.java`，它会：

1.  从当前登录用户信息里取出 `tenantId`。
2.  判断当前表需不需要隔离（看是不是在 `ignoreTables` 里）。
3.  如果需要隔离，就在你的 SQL 后面自动追加 `AND tenant_id = 123`。

## 注意事项

+ 多租户不等于**权限过滤**，租户之间是完全隔离的。
+ 由于多租户ID 是**从当前登录用户信息获取**，所以像定时任务的处理，需要自行根据业务逻辑判断。
+ 启用多租户后，所有执行的 method 的 SQL 都会进行处理。
+ 自定义的 SQL 请按规范书写，特别是涉及到多个表的每个表都要给别名，特别是 inner join 的要写标准的 inner join。

## 往期教程合集

[RuoYi-SpringBoot3-Pro](https://mp.weixin.qq.com/mp/appmsgalbum?__biz=MzAwOTExOTc1MQ==&action=getalbum&album_id=4260128209435361290#wechat_redirect)

RuoYi-SpringBoot3-Pro 直接集成了 MyBatis-Plus 的多租户插件（TenantLineInnerInterceptor），不用再关注租户 ID，框架层自动给你注入过滤条件。配合 使用 Dify + AI 快速生成多数据库建表语句，使开发效率直线提升！

【RuoYi-SpringBoot3-Pro】：多租户功能上手指南

RuoYi-SpringBoot3-Pro 直接集成了 MyBatis-Plus 的多租户插件，不用再关注租户 ID，框架层自动注入过滤条件。配合 使用 Dify + AI 快速生成多数据库建表语句，使开发效率直线提升！

后端

架构设计

数据库

RuoYi-SpringBoot3-Pro集成MyBatis-Plus多租户插件，轻松实现SaaS系统数据隔离。通过简单配置tenant.enable=true即可启用，自动为SQL注入租户过滤条件。支持自定义租户字段、过滤表和忽略表，内置超级管理员权限管理。基于MyBatis-Plus拦截器实现，开发效率高，适合快速构建多租户系统。

SaaS

tencentdb-catalog

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

RuoYi-SpringBoot3-Pro集成MyBatis-Plus多租户插件，轻松实现SaaS系统数据隔离。通过简单配置tenant.enable=true即可启用，自动为SQL注入租户过滤条件。支持自定义租户字段、过滤表和忽略表，内置超级管理员权限管理。基于MyBatis-Plus拦截器实现，开发效率高，适合快速...

【RuoYi-SpringBoot3-Pro】：多租户功能上手指南-腾讯云开发者社区-腾讯云

【RuoYi-SpringBoot3-Pro】：多租户功能上手指南

【RuoYi-SpringBoot3-Pro】：多租户功能上手指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐