最有效方式是直接模拟租户上下文并验证业务逻辑对tenant_id的依赖是否生效，重点测试切换后行为是否符合租户预期，包括ThreadLocal/ScopedValue模拟、MockMvc请求级验证、数据层过滤效果及非法租户场景覆盖。
直接模拟租户上下文并验证业务逻辑对 tenant_id 的依赖是否生效，是测试多租户上下文切换最有效的方式。重点不是测“切换动作”本身，而是测“切换后行为是否符合租户预期”。
用 ThreadLocal 或 ScopedValue 模拟上下文
若系统使用 ThreadLocal<String> 存储租户 ID，测试中需在当前线程显式设置并清理：
- 调用
TenantContext.setTenantId("tenant-a")注入测试租户 - 执行待测方法（如
userService.findAll()） - 断言结果是否包含 tenant-a 的数据，或 SQL 是否自动注入
WHERE tenant_id = 'tenant-a' - 测试结束后务必调用
TenantContext.clear()，避免污染其他测试用例
若已升级至 Java 21+ 并采用 ScopedValue<String>，则用 ScopedValue.where(tenantId, "tenant-b", () -> { ... }) 封装执行逻辑，无需手动清理，天然线程安全。
结合 Spring Test 模拟请求级上下文
多数多租户系统在 Filter 或 Interceptor 中解析租户标识。可借助 @WebMvcTest + MockMvc 构造带租户信息的 HTTP 请求：
立即学习“Java免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 通过 Header 传租户：
mockMvc.perform(get("/api/users").header("X-Tenant-ID", "vip")) - 通过子域名模拟：
mockMvc.perform(get("/api/users").header("Host", "vip.example.com")) - 验证 Controller 层是否正确识别，并触发对应数据源路由或权限控制分支
注意：确保测试配置中启用了相关 Filter（如 @Import(TenantFilter.class)），否则上下文不会被初始化。
验证动态数据源/SQL 过滤是否生效
租户上下文最终要落地到数据访问层。测试时应聚焦实际效果而非实现细节：
- 使用
@DataJpaTest或嵌入式 H2 数据库，预置两条不同 tenant_id 的记录 - 在
TenantContext.setTenantId("tenant-1")后调用 Repository 查询方法 - 断言返回结果仅含
tenant_id = 'tenant-1'的数据（非全部） - 若使用 MyBatis，可开启
logging.level.org.apache.ibatis=DEBUG查看生成的 SQL 是否含AND tenant_id = ?
覆盖租户缺失或非法场景
健壮性测试不能只关注正常流程：
- 设
TenantContext.setTenantId(null)或空字符串，验证是否抛出TenantNotFoundException - 传入未注册租户 ID（如 "unknown-tenant"），检查是否拒绝服务或走默认降级路径
- 若功能开关按租户等级控制（如免费版禁用导出），需分别用 "free" 和 "enterprise" 租户 ID 测试行为差异
不复杂但容易忽略
