需建立严格隔离的多租户测试环境,具体路径包括:一、基于环境变量创建独立租户配置;二、利用工作区物理隔离项目;三、通过集合命名空间与标签逻辑分组;四、启用Git分支策略管理版本;五、使用Inso CLI按租户粒度执行自动化测试。

如果您在Insomnia中需要同时对多个租户(如不同客户、不同业务线或不同部署环境)的API进行独立测试,但各租户共享同一套请求集合且存在端点、认证、密钥等配置冲突,则需建立严格隔离的多租户测试环境。以下是实现该目标的具体路径:
一、基于环境变量创建独立租户环境配置
通过为每个租户定义专属环境变量文件,实现URL、认证凭证、租户标识等参数的完全解耦,避免跨租户配置污染。所有变量均以{{tenant_xxx}}语法在请求中引用,运行时动态注入。
1、点击左下角“Environments”面板右上角“+”号,选择“Create Environment”。
2、命名为“TenantA-Prod”,在JSON编辑区填入以下内容:
{
"base_url": "https://api.tenant-a.com/v2",
"tenant_id": "tenant_a_prod_001",
"auth_token": "Bearer xxx-prod-token-a",
"region": "us-east-1"
}
3、重复步骤1–2,创建“TenantB-Staging”环境,填入对应B租户的独立配置,确保无任何字段与TenantA环境重名或共享值。
4、在目标Collection右键 → “Edit Collection” → “Environment”下拉菜单中,为该集合绑定“TenantA-Prod”作为默认环境。
二、利用工作区(Workspace)物理隔离租户项目
工作区是Insomnia中最高层级的数据隔离单元,每个工作区拥有独立的Collections、Environments、Authentication配置和本地存储路径,天然支持租户级项目分离。
1、点击顶部菜单栏“File” → “New Workspace” → 选择“Local”类型。
2、命名为“TenantA-Project”,确认创建后,当前界面将清空所有原有集合与环境。
3、在该工作区中重新导入TenantA专属的API集合(.json或.insomnia格式),并仅配置TenantA相关环境。
4、通过顶部工作区切换器快速跳转至“TenantB-Project”,其内部所有配置与TenantA完全无关,包括OAuth缓存令牌、Cookie会话、断言脚本上下文。
三、通过集合命名空间与标签实施逻辑分组
当租户数量较多或需在单一工作区内临时并行调试时,可借助集合嵌套结构与自定义标签实现轻量级逻辑隔离,适用于预验证或交叉比对场景。
1、在当前工作区中新建Collection,命名为“[TenantA] User Management”,注意方括号前缀作为识别标识。
2、右键该Collection → “Add Tag” → 输入“tenant-a”并保存。
3、对该Collection内所有请求的Headers中Authorization字段,统一使用{{auth_token}},该变量仅在绑定的“TenantA-Prod”环境中定义。
4、执行集合运行器(Runner)时,在过滤条件中输入tag:tenant-a,即可仅运行该租户关联的全部测试用例,其他租户标签的请求不会被加载或执行。
四、启用Git分支策略管理租户配置版本
结合Insomnia的Git同步功能,为每个租户维护独立Git分支,使环境变量、请求体模板、测试脚本等配置具备完整版本历史与合并控制能力,防止误提交导致租户配置混杂。
1、确保工作区已启用Git同步:右键工作区 → “Enable Git Sync”,关联远程仓库。
2、在终端中进入工作区本地路径,执行git checkout -b tenant-a-main。
3、在该分支下修改“TenantA-Prod”环境变量及所属集合,提交并推送:git add . && git commit -m "setup tenant A prod env" && git push origin tenant-a-main。
4、为TenantB新建分支tenant-b-staging,所有变更仅存在于该分支,主分支(main)不包含任何租户敏感配置,仅保留通用模板与文档。
五、使用Inso CLI按租户粒度执行自动化测试
Inso CLI支持通过--environment参数精确指定运行时生效的环境,并可配合--collection-filter限定仅执行匹配租户前缀的集合,实现CI/CD流水线中租户级测试的精准触发与报告分离。
1、在项目根目录执行命令,仅运行TenantA相关测试:
inso run test "TenantA*" --environment "TenantA-Prod" --ci --reporter json --output report-tenant-a.json
2、执行TenantB测试时,显式传入不同环境与集合模式:
inso run test "TenantB*" --environment "TenantB-Staging" --ci --reporter json --output report-tenant-b.json
3、生成的两个JSON报告文件彼此独立,字段中均包含"environmentName": "TenantA-Prod"等明确归属标识,便于后续聚合分析时按租户维度切片统计失败率与响应延迟。

















