自动化测试
为什么测试场景在我的本地客户端运行没有问题，但在 Apidog CLI 或运行器中运行时会出错？
最常见的问题涉及变量的使用。
在 Apidog 本地客户端中运行时，会使用存储在客户端中的变量“当前值”，该值不会同步到服务器。然而，在 CLI 或运行器中运行时，会使用存储在服务器上的“初始值”。
为确保在本地和远程都能顺利运行，你 需要正确设置初始值和当前值，并保持它们一致。
: function → Boolean: 检查测试变量是否存在。pm.iterationData.get(variableName:String): function → ...
如何在 Apidog 中批量运行测试场景？
Apidog 支持批量运行多个已配置的测试场景。
在测试模块中，点击左侧文件夹树中的某个文件夹，右侧面板将显示该文件夹内所有测试场景的列表。在此列表中，你可以查看每个测试场景的信息，例如环境和最近一次运行结果。
你可以选择多个测试场景，然后点击右上角的“批量运行”按钮，以批量执行这些...
如何在 Apidog 中安排测试任务？
你可以设置“定时任务”，以便在指定时间自动运行已配置的自动化测试场景，获取任务执行结果，并满足定时测试和回归测试的需求。
:::tip[]
定时任务目前处于 Beta 阶段。
若要运行定时任务，你首先需要配置一个 self-hosted Runner。
你可以运行定时任务的次数取决于你订阅的计划。...
如何在 Apidog 中运行性能测试？
:::tip[]性能测试功能目前处于 Beta 阶段。:::
性能测试是指向 API 发送大规模服务请求，以识别性能瓶颈、评估稳定性、暴露压力下的潜在风险，并确保 API 能够在高负载下可靠运行并响应请求。
设置配置项
在运行性能测试之前，你需要为测试场景指定运行环境，并可选地指定测试数据，同时配...
如何在性能测试中查看实际请求和响应？
Apidog 的性能测试不提供查看实际请求和响应的能力。
这是因为性能测试侧重于评估 API 在高负载下的行为，而这些 API 应该已经 100% 通过了功能测试。任何问题都很可能是由服务器性能导致的，而不是请求/响应内容导致的。
因此，查看实际请求和响应并不能帮助排查与性能相关的问题。因此，Api...
如何在 Apidog 中导出性能测试报告？
性能测试目前处于 Beta 阶段，Apidog 暂不支持导出性能测试报告。你只能在 Apidog 客户端内查看结果。
如何使用数据库查询结果作为循环 API 请求的参数？
Apidog 支持使用数据库查询结果作为参数来循环执行 API 请求。你可以按照以下步骤操作：
在你的测试场景中，添加一个“数据库操作”步骤。执行你的 SQL 查询，并将结果提取到一个变量中（例如 `id`）。确保你的 SQL 查询返回数组格式的结果。
![](https://...
在 CI/CD 期间使用 ApiDog 捕获并验证 Stripe Webhook
问：ApiDog 是否支持直接监听 Stripe Webhook？不，ApiDog 原生不支持监听 Webhook。但是，你仍然可以通过利用后端和数据库来验证 Webhook 事件。
问：使用 ApiDog 测试 Stripe Webhook 的推荐方法是什么？你可以按照以下步骤操作：
在后端设置...
如何解决“Error: unable to verify the first certificate on runner”错误？
运行 Apidog 的 Runner 时，如果遇到“Error: unable to verify the first certificate on runner”错误，通常是因为 Runner 无法验证服务器的 SSL 证书。这可能是由于服务器使用了自签名证书，或者证书链中的某个证书不受信任。
你...
General Runner Docker 容器 “Not Found” 错误。
Q: 问题是什么？A: 当用户按照 Apidog 文档（https://docs.apidog.com/general-runner-755233m0）尝试运行 General Runner Docker 容器时，会遇到 “Not Found” 错误。该错误发生在 runner 尝试访问以下端点时：...
如何在 Apidog Web 版中为通用 Runner 设置服务器 Host？
由于浏览器安全限制，Web 版无法从 HTTPS 页面访问不安全的 HTTP。因此，在 Web 版中为通用 Runner 设置服务器 Host 可能会失败。
请改为在 Apidog 客户端 中进行配置。
为什么定时测试场景最终显示 0 个请求？
Q: 为什么我的定时测试场景最终显示 0 个请求？
A：没有请求通过定时任务，因为为定时运行设置的环境被设置为“Private”。在 Apidog 中，当环境为私有时，定时测试可能无法访问所需变量，从而导致请求失败。
Q: 如何修复此问题？
A: 要解决此问题，请在 Apidog 中将环境从“Pri...
如果在 Runner 或 CLI 中找不到文件上传参数，我该怎么办？
Apidog 仅存储本地文件路径，而不存储文件本身。因此，当在不同机器上使用 Runner 或 CLI 运行测试时，可能会遇到找不到文件的错误。
要解决此问题：
将文件上传到运行测试场景的 Runner/CLI 机器。
在 Apidog 中，打开相应的测试步骤，并使用“批量编辑”将文件路径参数值替...
如何使用 Runner 运行包含上传文件步骤的测试场景？
在 Apidog 中，端点请求中的文件参数实际上只保存文件路径（而不是文件本身）。发送请求时，Apidog 会根据文件路径查找实际文件，然后发送。因此，你需要确保：
将文件复制到挂载到 Runner 卷的宿主目录中。Runner 的卷是在[部署 Runner](apidog://li...
如何解决“Error: unable to verify the first certificate on runner”错误？
如果你在使用 Apidog 运行 Runner 时遇到“Error: unable to verify the first certificate on runner”错误，通常是因为 Runner 无法验证服务器的 SSL 证书。这可能是由于服务器使用了自签名证书，或证书链中存在不受信任的证书。
...
当 Runner 出现问题时，如何访问和搜索 Runner 日志以识别问题？
使用 the docker ps 命令查找有问题的 Runner 信息；
根据 Runner 容器 ID，运行以下命令查询有效日志
# View the last 100 lines of the log for container ID abc123, recommended:
docke...
如果端点参数是上传文件，并且在 Runner 或 CLI 中找不到，我该怎么办？
Apidog 只保存文件的本地路径，而不保存文件本身。因此，当在不同机器上使用 Runner 或 CLI 运行测试时，你可能会遇到找不到文件的错误。
解决方案：
将文件上传到运行测试场景的服务器
在 Apidog 中打开对应的测试步骤，通过参数的批量操作将文件路径参数替换为该机器上的真实路径，或...
为什么 API 用例变更时测试步骤不会自动同步？
如果步骤是从端点用例导入的，并选择以 copy 方式导入当端点的用例发生变更时，步骤不会发生变化，并且两者之间没有关联。
如果步骤是从端点用例导入的，并选择“引用”方式端点用例中的任何变更都会同步 到测试步骤内容，反之，步骤变更也会同步到端点用例。
因此，如果你需要测试步骤与端点用例保持完全同...
为什么在 Markdown 文档中使用多个美元符号会导致某些内容无法正确显示？
Apidog 使用的 Markdown 编辑器会将 $xxxxx$ 解析为数学公式。如果你的内容不是数学公式，但包含多个 $，则可能解析失败并无法正确显示。为避免这种情况，可以采用以下方法：
方法 1. 使用行内代码块
将代码内容包含在反引号中，例如
原始内容
`...
自托管 Runner 在执行任务后会在服务器上生成测试报告吗？
测试报告不会本地存储在 Runner 中，请在客户端中查看。
我可以为测试场景中的请求添加统一的前置/后置处理器吗？
可以，Apidog 支持为测试场景配置统一的前置/后置处理器。启用后，当场景运行时，场景内的所有请求都会自动执行相同的前置/后置处理器。
要启用此功能：
前往项目设置。
![img_v3_02mu_2a6d3e2f-8a5b-407c-a0f9-94a28dc692fg.png](http...
如何在单次自动化测试运行期间保持动态值一致？
动态表达式（例如 {{$person.fullName}}）每次被调用时都会生成一个新值。如果你在测试流程中多次将此类表达式直接赋值给变量，可能会导致各步骤之间的数据不一致。
推荐方法：
先生成一次动态值，将其存储在变量中，然后在整个测试中引用该变量。变量在赋值时只会被求值一次，从而确保整个测试运行...