切换租户#

验证状态：已源码核验、未联调；适用基线：冻结 inventory（2026-09-11）；复核基线：源码归纳 @ 2026-09-14

用途与场景#

把当前会话切换到另一租户（普通用户须是其成员）。成功后服务端更新登录租户缓存并重新签发 token；供 Web 当前调用链使用，App 切换空间应走同一动线（概念见认证与空间）。

使用位置#

调用点和 API wrapper 已记录在冻结 inventory。

端点#

PUT /main-service/system-api/user-center/user/switchTenant?tenantId={tenantId} — 切换当前登录租户并重新签发 token。

端点全量事实（参数、请求/响应字段、错误码、权限点）见清单层 user-center · user 用户；多租户声明与切换动线（重新签发而非吊销）见用户中心业务 · user 用户；目标租户清单来自读取可切换租户。

动线与完成判据#

成功表示缓存更新并返回新 token，调用方必须替换。

错误与边界#

tenantId 缺失按参数校验拒绝；非 administrator 切换到非成员租户抛业务拒绝（Wrong tenant id）；成功更新登录租户缓存并重新签发 token，旧 token 被替换而非吊销。错误出口见错误响应差异。

调用关系与资源清理#

未发现本操作的订阅或长连接资源；调用方仅在业务成功后推进界面状态。

已知缺口#

未执行真实联调；切换后 MQTT 连接需以新凭据重建的时序未由本接口闭合。