ContiNew
多租户

租户管理

租户管理页面维护租户档案，创建租户时自动生成编码并初始化角色、管理员等基础数据，支持绑定套餐与重置管理员密码。

本文是 4.x 的归档文档（冻结于 v4.2.0）。该分支只接收勘误修正， 内容基本不再变动；文中的源码路径、配置项与版本号均以 4.2.x 为准，不建议用于新项目。

新项目请查看 5.x 最新文档。已在 4.2.x 上运行的项目，本文仍是可靠依据。

「租户管理 → 租户管理」页面维护平台内全部租户档案，数据存于 tenant 表。对应接口前缀 /tenant/management，基于 CRUD 套件提供分页、详情、新增、修改、删除五个标准接口。

租户字段

TenantDO 定义的租户档案字段：名称、编码、域名、过期时间、描述、状态（启用或禁用）、管理员用户 ID、管理员用户名、套餐 ID。其中编码由系统生成，管理员账号在创建时一并初始化。

创建租户

新增租户时 TenantServiceImpl.create 按以下顺序执行，整体包裹在事务中。

校验名称与域名全局唯一，重复时抛出「名称为 [xxx] 的租户已存在」类错误。

校验所绑套餐状态，套餐被禁用时拒绝创建。

生成租户编码。编码由 CosID 的 tenant-code 生成器产出，RADIX 进制、固定 T 前缀，生成后查库去重。

写入租户记录，然后遍历所有 TenantDataApi 实现完成租户数据初始化：创建租户管理员角色与账号、按套餐菜单授权等。删除租户时同样经 TenantDataApi 在对应租户上下文内逐模块清理数据。

状态检查与登录拦截

租户在每次请求进入时经受 TenantServiceImpl.checkStatus 校验，依次检查租户存在、未被禁用、未超过过期时间、所绑套餐未被禁用，任一不满足即拒绝请求。默认租户（ID 0，超级管理员所在租户）直接放行，不做状态与过期检查。DefaultTenantProvider 负责从请求头解析租户：普通请求读 X-Tenant-Id，登录相关接口读 X-Tenant-Code 并换算为租户 ID。/auth/refresh 与 /auth/logout 不经过租户拦截器（@TenantIgnore），租户上下文取自 Refresh Session 中保存的 tenantId，因此跨租户用户的会话轮换与登出不受请求头影响。

租户修改或删除后，后端会清空以 TENANT: 为前缀的租户缓存，并使该租户下全部在线会话失效，租户用户需要重新登录才能继续操作。对应逻辑在 TenantServiceImpl.afterUpdate。

修改租户管理员密码

列表操作列的「重置密码」调用 PUT /tenant/management/{id}/admin/pwd，权限码 tenant:management:updateAdminUserPwd。前端使用 RSA 公钥加密新密码提交，后端 SecureUtils.decryptPasswordByRsaPrivateKey 解密后在目标租户上下文内调用用户模块的重置密码接口，全程不触碰平台管理员的账号体系。

相关源码

多租户

多租户模块基于 MyBatis-Plus 行级隔离实现租户数据隔离，通过租户与套餐两级管理控制各租户可用的菜单与数据范围。

套餐管理

套餐管理页面维护套餐与菜单的关联关系，套餐是租户可用菜单的规格模板，套餐变更会实时同步到所有引用它的租户。

目录

租户字段创建租户状态检查与登录拦截修改租户管理员密码相关源码