故障注入
畸形响应目录:看起来成功,内容却不对
「故障注入」只能给一个状态码 + 一个故障率,练的是"接口挂了怎么办"。但真正把前端打穿的往往不是 500,而是状态码 200、内容却不对的响应:只看状态码不看内容的代码会在这里静默拿到一堆脏数据。
用法:在每条响应的「故意打坏这一条(畸形响应)」里选一种。状态码由模式决定(截断的 JSON 仍是 200、半包是 206、重定向环是 302),原来填的状态码会被覆盖。
| 模式 | 状态码 | 长什么样 | 练的是什么 |
|---|---|---|---|
| 截断的 JSON | 200 | 响应体在半截被切断 | 最狠的一种:JSON.parse 必失败 |
| 语法错误的 JSON | 200 | 多了个逗号,语法不合法 | 解析器抛错时的兜底 |
| 空响应体 | 200 | Content-Length: 0,一个字节都没有 | "成功但没有数据"这条分支 |
| 半包 206 | 206 | 只回一半,带 Content-Range | 没拿全就当完整用了的错 |
| 重定向环 | 302 | 每次都 302 回自己 | 跟随重定向的上限 |
| 声称 gzip 却是明文 | 200 | 声明 Content-Encoding: gzip,正文是明文 | 解压失败时能不能给出可读的错误 |
| 没有 Content-Type | 200 | 响应头里没有这个头 | "按响应头决定怎么解析"在头缺失时的行为 |
| 超大响应头 | 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 写法(尾随逗号、注释、不带引号的键),带 {{...}} 模板变量的响应体也能安全排版:原来带引号的还是字符串,裸写的数字 / 布尔不会被加上引号。