Anymock

故障注入

畸形响应目录:看起来成功,内容却不对

「故障注入」只能给一个状态码 + 一个故障率,练的是"接口挂了怎么办"。但真正把前端打穿的往往不是 500,而是状态码 200、内容却不对的响应:只看状态码不看内容的代码会在这里静默拿到一堆脏数据。

用法:在每条响应的「故意打坏这一条(畸形响应)」里选一种。状态码由模式决定(截断的 JSON 仍是 200、半包是 206、重定向环是 302),原来填的状态码会被覆盖。

模式状态码长什么样练的是什么
截断的 JSON200响应体在半截被切断最狠的一种:JSON.parse 必失败
语法错误的 JSON200多了个逗号,语法不合法解析器抛错时的兜底
空响应体200Content-Length: 0,一个字节都没有"成功但没有数据"这条分支
半包 206206只回一半,带 Content-Range没拿全就当完整用了的错
重定向环302每次都 302 回自己跟随重定向的上限
声称 gzip 却是明文200声明 Content-Encoding: gzip,正文是明文解压失败时能不能给出可读的错误
没有 Content-Type200响应头里没有这个头"按响应头决定怎么解析"在头缺失时的行为
超大响应头200塞一个约 8KB 的响应头头部上限(停在 8KB:再大客户端会直接断连,练不到兜底)
编码对不上200声明 charset=gbk,发的却是 UTF-8 字节中文变乱码这种最常被当成对方 bug 的问题
  • 挂在每条响应上,不是规则上,所以能拼进响应序列:「第 1、2 条正常,第 3 条截断,第 4 条又正常」就是一条现成的故障链,练重试与退避最方便的配法。
  • 一律带 X-Mock-Fault: <模式名> 响应头,好让错误上报把"你故意打坏的接口"过滤掉,别混进线上告警。
  • 不认识的模式按不打坏处理,不会因为存了个脏值就变成永远报错的规则。
  • 目录免登录可取:GET /api/faults。
$ curl -i http://127.0.0.1:8080/m/abc
HTTP/1.1 200 OK                          # ← 状态码是 200
X-Mock-Fault: truncated-json

{"ok":true,"items":[{"id":1,"n           # ← 但正文断了,JSON.parse 必失败

内容查看(试一下 / 数据集)

「试一下」的响应和数据集的「查看数据」都用同一个只读编辑器(和响应内容的编辑框一样,行号、着色、折叠都是一个手感),右上角只有两个按钮:

按钮说明
格式化重新缩进排版并做语法着色:JSON 对齐缩进、XML / HTML 按层级缩进
紧凑压成一行,方便整段复制或对比长度

两个按钮哪个高亮,就表示当前内容是排版过的还是压成一行的;底部「复制内容」复制的是屏幕上看到的这一版。JSON 支持 JSON5 写法(尾随逗号、注释、不带引号的键),带 {{...}} 模板变量的响应体也能安全排版:原来带引号的还是字符串,裸写的数字 / 布尔不会被加上引号。