编排测试套件

创建测试套件后，你需要添加测试内容。Apifox 提供了灵活的 “静态” 和 “动态” 两种模式，满足不同的测试管理需求。

导入测试内容

在测试套件详情页的「编排」标签下，点击「添加接口测试用例」或「添加测试场景」。在弹出的选择窗口中，你可以切换「静态」或「动态」模式。

1. 静态模式 (Static Mode)

静态模式用于精确指定需要执行的测试项。

🎯 核心逻辑

系统记录你勾选的具体用例 ID。即使源目录增加了新用例，该套件的执行范围也不会改变，确保测试结果的可控性。

🚀 最佳使用场景

Bug 修复验证 (Hotfix)：挑选 3-5 个与本次 Bug 强相关的用例，组成一个 “验证包”，快速验证修复结果，不浪费时间跑无关用例。

核心业务固化 (Core Path)：针对 “下单-支付” 这种极其核心且稳定的流程。我们不希望因为新人误加了一个未完成的测试用例，导致核心监控报警。

旧版本兼容性测试：圈定一批旧接口测试用例，专门用于验证旧版本客户端的兼容性。

⚠️ 维护特性

高维护成本：如果有新用例需要纳入这个专项测试，必须人工手动添加。

2. 动态模式 (Dynamic Mode)

动态模式用于通过规则自动筛选需要执行的测试项。

🎯 核心逻辑

系统保存的是 “筛选规则”(Scope & Filter）。每次运行时，系统实时扫描整个项目，将所有符合条件的最新用例纳入执行计划。

🚀 最佳使用场景

模块级回归 (Regression)：将 “交易中心” 文件夹设为源目录。测试人员只需在文件夹里写新用例，套件运行时会自动包含它们，实现 “写完即入库”。

冒烟测试 (Smoke Test)：创建一个规则为 优先级 = P0 的动态套件。每次发版前运行，自动覆盖所有标记为 P0 的关键用例。

版本迭代验收：利用标签功能，规则设为 Tag = v2.5.0。开发完成后，直接运行该套件即可验收该版本所有新增功能。

⚠️ 维护特性

零维护成本：一旦配置好规则，后续无需维护套件本身，只需维护用例的属性（位置、标签、优先级）即可。

调整执行顺序

导入的内容会在列表中显示，你可以拖拽列表项来调整执行顺序。

对于「静态」添加的单项，可以使用编辑功能，进行单独删除/整组删除。

对于「动态」添加的组，只能整体删除或编辑过滤条件，无法删除组内的单个动态项。

内容高级配置

在测试套件的编排页面右侧，可以展开「高级配置」，对测试套件的运行方式进行更细粒度的控制。

运行环境

定义：默认继承测试套件中已设置的运行环境。若在此处单独指定环境，则运行将优先生效该环境配置。

使用场景：适用于需要在不同环境下复用同一套测试步骤的场景。

测试数据

用于指定是否在运行过程中使用测试数据。

不使用测试数据：测试步骤仅执行一次，不进行数据驱动。

使用测试数据：基于测试数据进行多次运行，常用于参数化测试。

遇到错误时

用于控制测试过程中出现错误时的处理方式。错误包括断言失败、数据格式校验失败、接口请求异常、服务器错误等。

忽略：出现错误时继续执行后续步骤，不中断当前运行。

跳到下一轮循环：出现错误时，跳过当前轮剩余步骤，直接进入下一轮执行。

结束运行：一旦出现错误，立即终止后续步骤。

适合用于冒烟测试或调试阶段，快速暴露首个问题。

循环次数

定义：设置整个测试套件的重复执行次数。

使用场景：常用于稳定性验证或简单的压力测试场景。

间隔停顿

定义：设置每个测试步骤执行完毕后，等待多少毫秒（ms）再执行下一个步骤。

使用场景：防止因请求发送频率过高而触发目标服务器的限流（Rate Limiting）或熔断机制，确保测试平稳运行。

保存请求/响应详情

定义：控制测试报告中是否包含请求和响应的详细数据（如 Header、Body 等）。

选项：

全部请求：无论通过与否，保存所有步骤的完整详情。数据量较大，适合深度调试。

仅失败请求：只有运行失败的步骤才保存详情。推荐使用，既节省存储空间，又方便快速定位失败原因。

不保存：不保存任何详情，仅记录通过/失败的状态和耗时。

环境/全局变量值

环境/全局变量值，指定本测试场景中的环境/全局变量，使用何种实际值。有两种选择，详细介绍可以查看此处。当选择使用 Runner 中保存的变量值时，会要求进一步选择需要使用的变量范围。

有这个范围的目的是帮助用户更好的根据实际需求分隔变量，避免因为某次定时任务运行，而导致其它的任务因为变量被更改而运行失败。选择完成范围后还可通过产品界面中出现的入口来可视化查看此范围内的变量值。

Runner 中的变量范围	读写环境/全局变量方式	描述
当前测试场景	当前指定运行 Runner 中，此测试场景对应一个文件，在文件中持久化保存此测试场景内设置的环境/全局变量。仅当前测试场景可以读取、写入这个文件中的变量。	最小的变量范围，影响面最小。适用于此测试场景上一次运行的结果，要继续提供给下一次此测试场景运行使用的情况。场景、任务、任务目录的变量文件均保存在 Runner 容器路径 `/opt/runner/variables` 中。
当前定时任务	当前指定运行 Runner 中，此测试场景所属的定时任务对应一个文件，在文件中持久化保存此定时任务内所有测试场景设置的环境/全局变量。当前定时任务中，所有的测试场景可以读取、写入这个文件中的变量。	比较推荐使用的变量范围，中等的变量范围，影响面中等。适用于此定时任务中，不同测试场景之间需要传递数据的情况。
当前定时任务目录	当前指定运行 Runner 中，此测试场景所属的定时任务目录对应一个文件，在文件中持久化保存此定时任务目录内所有定时任务中测试场景设置的环境/全局变量。当前定时任务目录中，所有的定时任务里的所有测试场景可以读取、写入这个文件中的变量。	最大的变量范围，影响面最大，可能因为运行了某个定时任务修改了变量值，而导致其他定时任务运行失败。适用于一组定时任务之间需要传递数据的情况。

导入测试内容#

1. 静态模式 (Static Mode)#

2. 动态模式 (Dynamic Mode)#

调整执行顺序#

内容高级配置#

运行环境#

测试数据#

遇到错误时#

循环次数#

间隔停顿#

保存请求/响应详情#

环境/全局变量值#