模拟自己的应用程序的随机错误

2025-06-30

本教程介绍如何使用开发代理来模拟你自己的应用程序的随机错误。

先决条件

本教程的这一部分假定你在计算机上安装并配置了开发代理。否则，请立即执行。

若要遵循本教程，需要调用 API 的应用程序。还需要知道应用程序调用的 API 的 URL。

可以将开发代理与任何类型的应用程序和技术堆栈配合使用。下面介绍了如何使用一些常用技术设置开发代理。

将开发代理用于：

启动开发代理来监视 URL

启动开发代理并监视应用程序调用的 API 的 URL。例如，如果应用程序调用位于的 https://api.contoso.com/v1/customersAPI，请启动开发代理并监视 URL 模式 https://api.contoso.com/*。

devproxy --urls-to-watch "https://api.contoso.com/*"

--urls-to-watch 参数告知开发代理需要拦截哪些请求。 URL 末尾的通配符 * 告知开发代理截获以开头 https://api.contoso.com/的 URL 的所有请求。

像平常一样开始使用应用程序。开发代理将截获你指定的 URL 的所有请求。在命令提示符中，会看到有关开发代理截获的请求的消息。

```text
 request     GET https://api.contoso.com/v1/customers
     api   ╭ Passed through
           ╰ GET https://api.contoso.com/v1/customers
 request     GET https://api.contoso.com/v1/customers
   chaos   ╭ 403 Forbidden
           ╰ GET https://api.contoso.com/v1/customers

重要

如果在命令提示符中未看到任何消息，请确保正确将应用程序配置为使用开发代理。此外，检查开发代理是否正在截获应用程序使用的 API URL 的请求。如果有任何问题，请在 Discord 上的开发代理社区寻求帮助。

创建自己的配置文件

默认情况下，开发代理将 devproxyrc.json 开发代理安装文件夹中的文件用于其配置设置。该文件配置为模拟 JSON 占位符 API 的随机错误。若要获取更真实的结果，请创建自己的配置文件，其中包含与应用程序及其使用的 API 更相关的错误，并将其与开发代理配合使用。

假设你想要将配置文件存储在应用的项目文件夹中，以便你可以与团队的其余部分共享配置设置。

在开发代理安装文件夹中，复制 devproxyrc.json 和 devproxy-errors.json。
在项目文件夹中，粘贴文件。

使用存储在开发代理安装文件外部的配置文件时，需要确保 pluginPath 引用正确。请不要对配置文件中的开发代理安装文件夹路径进行硬编码，而是可以在路径开头使用 ~appFolder，以动态引用开发代理安装文件夹。

打开文本编辑器中的 devproxyrc.json 文件。
在 GenericRandomErrorPlugin 数组中找到 plugins 插件。
将 pluginPath 更新为 ~appFolder/plugins/DevProxy.Plugins.dll.
在 RetryAfterPlugin 数组中找到 plugins 插件。
将 pluginPath 更新为 ~appFolder/plugins/DevProxy.Plugins.dll。
在命令提示符中，将工作目录更改为项目文件夹。
输入 devproxy --config-file devproxyrc.json 并按 Enter 以使用配置文件启动开发代理。
从命令行向 JSON 占位符 API 发送请求并查看输出。
按 Ctrl + C 以安全地停止开发代理。

小窍门

安装适用于 Visual Studio Code 的 Dev Proxy Toolkit 扩展，以便轻松创建和更新配置文件。

后续步骤

开发代理支持许多不同的方案，可帮助你构建更可靠的应用程序。浏览操作指南，了解如何使用不同的 Dev Proxy 功能并改进您的应用程序。

浏览操作指南