读取可切换租户#

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

用途与场景#

读取当前用户可切换的租户列表（缓存视图），是「切换空间」入口的数据源；查询范围自动限定在当前凭据用户，请求不能查他人。供 Web 当前调用链使用。

使用位置#

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

端点#

POST /main-service/system-api/user-center/tenant/listByUsernameCache — 读取当前用户可切换的租户缓存列表。

端点全量事实（参数、请求/响应字段、错误码、权限点）见清单层 user-center · tenant 租户；租户的业务语义见用户中心业务 · tenant 租户；切换动作见切换租户。

动线与完成判据#

成功表示缓存列表读取完成。username 的作用域规则（非空时仅 administrator 生效；空串或非 administrator 一律解析为当前登录名）与 sqlQueryLimit 钳制语义见用户中心业务 · tenant 租户。

错误与边界#

username query 缺失按请求校验族拒绝（出口见差异页请求校验）。读取可按网络策略重试。其余错误出口见错误响应差异。

调用关系与资源清理#

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

已知缺口#

未执行真实联调；TenantListResponseDTO 字段可空性与缓存 TTL 未逐项闭合。