编排测试套件

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

导入测试内容

在测试套件详情页的 Orchestration 标签页下，点击 + Add Endpoint Test Case 或 + Add Test Scenario。在弹出的选择窗口中，你可以在 Static 或 Dynamic 模式之间切换。

1. 静态模式

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

🎯 核心逻辑

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

🚀 最佳使用场景

Bug 修复验证（Hotfix）：选择 3-5 个与 Bug 强相关的测试用例，组成一个“验证包”，快速验证修复结果，而无需浪费时间运行无关用例。

核心业务稳定性保障（Core Path）：适用于“下单-支付”等极其核心且稳定的流程。我们不希望因为新人误添加了一个未完成的测试用例而触发监控告警。

旧版本兼容性测试：专门选择一批旧端点测试用例，用于验证旧版本客户端兼容性。

⚠️ 维护特性

维护成本高：如果需要将新用例纳入此专项测试，必须手动添加。

2. 动态模式

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

🎯 核心逻辑

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

🚀 最佳使用场景

模块级回归测试：将“交易中心”文件夹设置为源文件夹。测试人员只需在该文件夹中编写新用例，套件在运行时会自动纳入这些用例。

冒烟测试：创建一个规则为 Priority = P0 的动态套件。在每次发布前运行，以自动覆盖所有标记为 P0 的关键用例。

版本迭代验证：使用标签功能，将规则设置为 Tag = v2.5.0。开发完成后，运行该套件以验证该版本的所有新功能。

⚠️ 维护特性

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

调整执行顺序

导入的内容将以列表形式展示，你可以拖拽列表项来调整执行顺序。

对于“静态”添加的项目，你可以使用 Edit 单独删除测试用例，或删除整个分组。

对于“动态”添加的分组，你只能删除整个分组或编辑筛选条件，不能删除分组内的单个项目。

高级配置

在测试套件设计页面右侧，你可以展开 Advanced Config，以便对测试套件的运行方式进行更细粒度的控制。

环境

定义：默认继承测试套件中已设置的运行环境。如果在此处指定了环境，则执行时将优先使用该环境配置。

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

测试数据

用于指定执行时是否使用测试数据。

无测试数据：测试步骤仅执行一次，不运行数据驱动测试。

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

出错时

配置测试应如何处理错误，错误可能包括断言失败、数据格式验证失败、端点请求异常、服务器错误等。

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

继续：发生错误时，跳过当前轮次的剩余步骤，并直接进入下一轮执行。

结束执行：一旦发生错误，立即终止后续步骤。

迭代次数

定义：每个线程循环执行所有步骤的次数。

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

延迟

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

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

保存请求/响应

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

选项：

全部： 无论通过/失败，都保存所有步骤的完整详情。数据量较大，适用于深度调试。

仅失败： 仅保存执行过程中失败步骤的详情。推荐使用，可节省存储空间，并便于快速定位失败原因。

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

环境/全局变量值

环境/全局变量值用于指定在此测试场景中，环境/全局变量应使用哪些实际值。有两种选择。详细信息可在此查看。当选择使用 Runner 中保存的变量值时，你需要进一步选择要使用的变量作用域。

该作用域的目的是帮助用户根据实际需要更好地隔离变量，避免出现某个定时任务运行导致变量发生变化，从而使其他任务失败的情况。选择作用域后，你还可以通过产品界面中出现的入口查看该作用域内的变量值。

Runner 中的变量作用域	读/写环境/全局变量	描述
仅在当前测试场景中共享	在当前指定的 Runner 中，此测试场景有一个专用文件，用于持久化存储其环境/全局变量。只有当前测试场景可以读写此文件中的变量。	最小的变量作用域，影响最小。适用于需要在下一次运行中使用此测试场景上一次运行结果的情况。测试场景、任务和任务文件夹的变量文件均保存在 Runner 容器路径 `/opt/runner/variables` 中。
在当前定时任务的所有测试场景中共享	在当前指定的 Runner 中，该定时任务有一个文件，用于存储可供其所有测试场景使用的环境/全局变量。当前定时任务中的所有测试场景都可以读写此文件中的变量。	推荐的变量作用域，影响适中。适用于需要在同一定时任务内的不同测试场景之间共享数据的情况。
在当前定时任务文件夹的所有定时任务中共享	在当前指定的 Runner 中，该定时任务文件夹有一个文件，用于存储可供其所有定时任务和测试场景使用的环境/全局变量。当前文件夹内所有定时任务中的所有测试场景都可以读写此文件中的变量。	最大的变量作用域，影响最显著。运行某个定时任务可能会修改变量值，从而导致其他定时任务失败。适用于需要在同一文件夹中的多个任务之间共享数据的情况。

导入测试内容#

1. 静态模式#

2. 动态模式#

调整执行顺序#

高级配置#

环境#

测试数据#

出错时#

迭代次数#

延迟#

保存请求/响应#

环境/全局变量值#