# SpringBoot 多租户实战：一套系统，怎样服务多家公司

同一套企业管理系统，甲公司需要组织、人事和审批，乙公司先用客户与项目。两家企业的账号、部门和业务记录分别管理，平台继续维护同一份产品能力。

多租户要解决的，正是这种“共用平台、分别使用”的问题。它既涉及后台怎样隔离数据，也涉及新企业第一次登录时，能不能拿到一套清楚、可用的初始配置。

这篇沿着 RuoYi Office 一次真实教学开通过程展开：先配套餐，为“青禾教学企业”创建空间，检查初始化，再用企业管理员登录。然后追进 SpringBoot 的请求、数据库和缓存实现，看看界面上的差别是怎样产生的。

![SpringBoot多租户连接企业身份、数据库过滤与缓存命名空间](https://developer.qcloudimg.com/http-save/yehe-12798805/f6aa68aa386d45b8e05cebb85334c465.png)

## 新企业登录后，先看到什么

先看结果。青禾教学企业的管理员进入同一个系统后，顶部显示企业自己的名称，系统管理下只有套餐开放的组织、用户、角色和岗位入口。组织页中，初始记录是“青禾教学总部”。

![青禾教学企业登录后的组织页面及企业专属菜单范围](https://developer.qcloudimg.com/http-save/yehe-12798805/d7b15c16833e8dd652802eb3f0e0c638.png)

*2026年10月17日教学环境历史画面。这里实际核对的是企业菜单和组织记录，不能据此推断所有业务模块都已通过隔离验证。*

课程中还保留了平台管理员的独立会话作对照：平台空间已有原来的公司和研发部门，青禾空间没有直接显示这些组织。新企业用户页起初只有初始化管理员，角色为租户管理员。

这比“登录成功”多走了一步。企业第一次使用系统，通常要同时确认三件事：进入的是哪家企业、允许使用哪些功能、当前空间已有谁和哪些组织。

租户与部门也在这里分开。租户是一家企业或一个需要独立管理的使用空间；部门属于这个空间内部。集团内部协作是否需要多个租户，要结合共享数据和组织权限决定，不能把每个部门都拆成一家公司。

## 套餐负责企业范围，角色负责员工分工

开通之前，平台管理员先配置“教程04-基础管理套餐”。这次只开放工作台及组织、用户、角色、岗位管理，不把平台的租户开通能力交给普通企业。

![基础管理套餐按菜单树选择企业可使用的功能](https://developer.qcloudimg.com/http-save/yehe-12798805/708926ad8c033ea9a949df93f9f42dd8.png)

*历史配置过程中的画面，尚在逐项勾选；画面里的即时勾选数不是最终套餐权限总数。*

套餐页面还有流程模型、默认角色、组织骨架等初始化配置。教学过程中把根部门设置为“青禾教学总部”，没有选择和发布流程模型。这样新企业拿到的是最小可用空间，后续再准备员工、岗位与业务规则。

这里的产品设计值得保留：**企业买到或启用的功能范围，与企业内部谁来使用，是两层配置。**

例如套餐允许使用客户管理，销售人员仍要取得对应角色权限；套餐没有开放的平台管理能力，也不能靠给普通员工加一个角色变出来。

| 对象 | 负责什么 | 开通时怎样核对 |
| --- | --- | --- |
| 套餐 | 企业可用菜单及初始化配置 | 选中所需能力，保存后回查 |
| 租户 | 企业身份、有效期与账号额度 | 企业名称和套餐一致 |
| 租户管理员 | 管理本企业用户、角色和组织 | 使用独立企业账号登录 |
| 员工角色 | 企业内部岗位分工 | 在该企业实际可用范围内授权 |

当前创建管理员角色的实现，会从套餐的菜单集合分配权限。平台和企业共用一套产品页面，最终看到的入口仍由各自身份和授权范围决定。

## 创建成功之后，还要等初始化完成

创建青禾教学企业时，选择刚才的基础套餐，配置初始管理员、账号额度和有效期，再填写企业显示名。教学例子的账号额度为20，有效期到2027年10月31日；账号额度不是同时在线人数。

下面是开通后重新打开的配置，用来回查已保存的结果。

![青禾教学企业已保存的套餐、账号额度与有效期](https://developer.qcloudimg.com/http-save/yehe-12798805/dd7445c8140ef50c9cdb1e85546867e8.png)

*历史“修改租户”页面。联系人为教学管理员，未填写联系电话；本图不包含管理员口令，也不是首次创建表单。*

保存后，系统建立初始化任务。这次历史记录为套餐115、租户136、初始化任务19，任务最终显示100%完成。记录这些编号的实际作用，是中断后能回到同一条任务继续检查，避免反复创建同名企业。

![租户创建后的套餐初始化任务显示完成结果](https://developer.qcloudimg.com/http-save/yehe-12798805/a6e57ce13a789aea79efb49ff2e69d49.png)

*历史任务19完成画面。本课没有选择流程模型，通用完成提示不能解释为已经复制或发布全部审批流程。*

当前 `TenantServiceImpl` 把开通拆成两段：先通过事务方法创建租户、管理员、默认首页和待处理任务，事务返回后，再交给执行器运行套餐初始化。

```java
public TenantCreateRespVO createTenant(TenantSaveReqVO createReqVO) {
    // 先走代理提交事务，再异步初始化，确保工作线程能读到已落库租户
    TenantCreateRespVO resp = self.createTenantAndEnqueueInit(createReqVO);
    Long adminUserId = resolveCreateAdminUserId(resp.getTenantId());
    Long packageId = createReqVO.getPackageId();
    tenantTransferExecutor.execute(() -> runCreateInitJob(
            resp.getInitJobId(), packageId, resp.getTenantId(), adminUserId));
    return resp;
}
```

这里使用自注入的 `self` 调用事务方法，是为了让同步创建先经过代理并完成事务，再启动后续初始化。异步线程如果抢在事务提交前读库，可能拿不到刚创建的租户或管理员。

任务进度则把这段后台过程变成用户能理解的状态：正在准备、已完成，或者需要核对失败原因。接口返回了租户编号，还不能替代后面的组织与管理员回查。

![套餐、租户、管理员及业务数据之间的逻辑关系](https://developer.qcloudimg.com/http-save/yehe-12798805/a1d5c26f3e7e8e0e09a035fe580bedb9.png)

*套餐定义功能与初始化配置；租户关联套餐，租户内组织、用户和角色分别保存自己的记录。图中为逻辑关联。*

## 请求带来的租户编号，要与登录身份对上

企业登录后，普通请求会携带租户标识。请求进入时，`TenantContextWebFilter` 解析 `tenant-id`，写入当前上下文；请求结束后在 `finally` 中清理。

有了标识，还要核对身份。`TenantSecurityWebFilter` 对普通登录请求检查：如果没有上下文租户，就使用登录用户的租户；如果两者不一致，返回无权访问。

```java
if (user != null) {
    // 如果获取不到租户编号，则尝试使用登陆用户的租户编号
    if (tenantId == null) {
        tenantId = user.getTenantId();
        TenantContextHolder.setTenantId(tenantId);
        // 如果传递了租户编号，则进行比对租户编号，避免越权问题
    } else if (!Objects.equals(user.getTenantId(), TenantContextHolder.getTenantId())) {
        log.error("[doFilterInternal][租户({}) User({}/{}) 越权访问租户({}) URL({}/{})]",
                user.getTenantId(), user.getId(), user.getUserType(),
                TenantContextHolder.getTenantId(), request.getRequestURI(), request.getMethod());
        ServletUtils.writeJSON(response, CommonResult.error(GlobalErrorCodeConstants.FORBIDDEN.getCode(),
                "您无权访问该租户的数据"));
        return;
    }
}
```

前端选择了某家企业，并不因此获得切换到其他企业的权限。后续数据库与缓存操作使用的上下文，需要建立在这次身份核对之上。

平台运维确有跨租户访问场景，当前另有受 `system:tenant:visit` 权限约束的访问上下文拦截器。它属于明确授权的管理路径，不能与普通企业用户请求混在一起，更不能为了方便测试就全局关闭租户检查。

对非忽略的接口，过滤器还会检查租户标识是否存在，以及租户状态、有效期是否可用。续期、停用这些平台配置，最终会影响实际请求的处理。

## 数据库过滤，关键在接入规则

查组织、查用户时，业务层通常写的是业务条件，租户范围由统一拦截器参与处理。当前使用 MyBatis-Plus 的 `TenantLineInnerInterceptor`，配合 `TenantDatabaseInterceptor` 提供租户编号和表的处理规则。

组织、用户的数据对象都继承 `TenantBaseDO`。租户过滤与具体业务查询结合，才形成“同类页面，各自读本企业记录”的效果。

但是，不能仅看一张表里有 `tenant_id`，就认定所有查询都接上了。当前表判断中的关键路径如下：

```java
TableInfo tableInfo = TableInfoHelper.getTableInfo(tableName);
if (tableInfo == null) {
    return true;
}
// 如果继承了 TenantBaseDO 基类，显然不忽略租户
if (TenantBaseDO.class.isAssignableFrom(tableInfo.getEntityType())) {
    return false;
}
// 如果添加了 @TenantIgnore 注解，则忽略租户
TenantIgnore tenantIgnore = tableInfo.getEntityType().getAnnotation(TenantIgnore.class);
return tenantIgnore != null;
```

这里的返回值表示是否忽略该表。没有取得 MyBatis-Plus 表元数据时，会走忽略路径；已经配置在忽略名单中的表，或全局忽略上下文，也有各自的处理分支。

因此，新增业务模块时，要一起核对数据对象、租户字段、拦截器配置与实际查询。尤其是自定义SQL、特殊报表和跨模块统计，必须看真实执行范围，不能靠一个基类名称推导全部隔离成功。

这套机制讨论的是共享数据访问路径中的逻辑隔离。它不等于每个企业各自一台数据库，也不会自动替你解决备份恢复、资源争抢或客户级独立升级。

## 数据库分开了，缓存也要分开

如果甲、乙两家公司分别读取自己的客户或配置数据，却把结果写进同一个缓存范围，后续读取仍可能拿错结果。

当前 `TenantRedisCacheManager` 的处理很清楚：在没有忽略租户、当前有租户编号、缓存名称不在例外名单时，为缓存名称追加租户后缀。

```java
@Override
public Cache getCache(String name) {
    String[] names = StrUtil.splitToArray(name, SPLIT);
    // 如果开启多租户，则 name 拼接租户后缀
    if (!TenantContextHolder.isIgnore()
            && TenantContextHolder.getTenantId() != null
            && !CollUtil.contains(ignoreCaches, names[0])) {
        name = name + ":" + TenantContextHolder.getTenantId();
    }

    // 继续基于父方法
    return super.getCache(name);
}
```

可以把它理解为给缓存区域增加企业身份。最终Redis键还受缓存管理器前缀、具体缓存键等规则影响，不能把一个示意后缀当成真实环境的完整键格式。

这个类处理的是经由该缓存管理器访问的缓存。业务代码直接操作 `RedisTemplate`、自定义Redis DAO或其他缓存实例时，仍要沿着自己的键设计检查。平台级共享缓存放进例外名单，也需要有明确理由。

![请求从租户上下文经过身份、数据库与缓存后清理的处理顺序](https://developer.qcloudimg.com/http-save/yehe-12798805/4846232a435364efd36e634fe9348297.png)

*普通企业请求的主要处理关系。平台授权访问、后台任务等路径另有上下文处理，不从这张图推断全部入口采用完全相同的顺序。*

## 后台线程，要把企业身份带进去再恢复

HTTP请求有开始和结束，初始化、定时任务和消息消费却可能运行在另外的线程里。把租户编号藏在页面参数里，解决不了后台操作属于哪家企业的问题。

当前上下文使用 `TransmittableThreadLocal`，框架也提供 `TenantUtils.execute`。其设计要点是：进入指定租户、执行当前逻辑、最后恢复原来的上下文和忽略状态。

```java
public static void execute(Long tenantId, Runnable runnable) {
    Long oldTenantId = TenantContextHolder.getTenantId();
    Boolean oldIgnore = TenantContextHolder.isIgnore();
    try {
        TenantContextHolder.setTenantId(tenantId);
        TenantContextHolder.setIgnore(false);
        // 执行逻辑
        runnable.run();
    } finally {
        TenantContextHolder.setTenantId(oldTenantId);
        TenantContextHolder.setIgnore(oldIgnore);
    }
}
```

前面的创建过程就是一个实际使用点：系统为新租户创建管理员和默认首页时，在该租户上下文中完成。任务、线程池和跨服务路径是否正确传递身份，还要核对各自接入方式，不能因为使用了可传递的ThreadLocal，就假定任意新线程、MQ或外部服务自动覆盖。

这里同样存在取舍：公共框架减少了每个业务方法重复写租户条件的负担，业务团队仍然需要清楚哪些操作进入了公共路径，哪些属于手工实现。

## 把一家新企业交付成“能用的空间”

这次青禾教学企业的操作给出了一条可复用的开通顺序：先选择功能范围，准备初始化配置，再创建租户、回查任务，最后用企业身份核对组织、用户和菜单。

课程还记录了两个具体细节：初始管理员当时没有自动关联根部门，需要在后续组织配置中处理；平台列表的套餐名称曾因缓存显示为空，但编辑弹窗与企业菜单范围正确。它们提醒我们，创建接口返回成功以后，仍要从最终使用身份回查，不能用平台表单替代企业端结果。

如果正在给企业软件增加多租户，可以按四层安排接入：

| 层次 | 先核对什么 |
| --- | --- |
| 企业开通 | 套餐、管理员、初始化任务与企业登录 |
| 请求身份 | 租户上下文与登录用户是否匹配 |
| 数据与缓存 | 业务表、特殊SQL、缓存管理器和手工键 |
| 后台执行 | 初始化、定时任务、消息的上下文进入与恢复 |

本文的实战画面来自2026年10月17日独立教学环境，本轮核读了当前实现，没有重新创建租户或执行跨租户攻击测试。组织与用户对照能说明当时的具体效果，性能容量、全部模块的数据边界和不同租户升级策略还需要分别验证。

对共用一套产品能力、按企业开通空间的团队，多租户提供了可持续维护的基础；需要物理隔离、完全不同版本节奏或特别资源要求的客户，则应继续评估独立部署。选哪一种，要落到客户的数据、配置和维护方式上。

同一套企业管理系统，甲公司需要组织、人事和审批，乙公司先用客户与项目。两家企业的账号、部门和业务记录分别管理，平台继续维护同一份产品能力。

SpringBoot SaaS多租户实战：一套系统，怎样服务多家公司

本文详解SpringBoot多租户实现：通过套餐配置企业功能范围，租户管理企业身份与权限，利用上下文过滤与数据库拦截器实现数据隔离。新企业登录后自动加载专属菜单、组织及初始化配置，请求阶段通过租户校验防止越权，结合MyBatis-Plus拦截机制确保查询仅返回本租户数据，实现“一套系统，多企独立使用”的高效共用模式。

后端

架构设计

数据库

SpringBoot多租户实战解析：一套系统如何服务多家企业，实现组织、用户与业务数据隔离。通过RuoYiOffice真实教学案例，演示套餐配置、租户创建、权限控制及缓存分离。掌握数据库拦截、上下文传递与后台任务处理，快速搭建可扩展的多租户SaaS平台，确保企业数据安全与独立管理。

代码解释

Redis

让每一个 Agent，都跑在云上

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

SpringBoot SaaS多租户实战：一套系统，怎样服务多家公司-腾讯云开发者社区-腾讯云

SpringBoot SaaS多租户实战：一套系统，怎样服务多家公司

SpringBoot SaaS多租户实战：一套系统，怎样服务多家公司

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐