Mock/断点
Mock 在请求或响应阶段拦截流量:可**手动 Mock**(全屏篡改弹窗内编辑后放行),或**自动 Mock**(按预设篡改后直接返回)。规则通过抓包列表可视化向导创建。
能做什么
Mock 适合联调里临时改接口、模拟异常响应、或阻断真实上游。每条规则包含:
- **匹配特征**:从真实请求拾取的 URL、Query、Body、请求头等条件(支持通配)。
- **Mock 方式**:手动 Mock(弹窗篡改后放行)或自动 Mock(按预设篡改内容放行;响应 Mock 可短路,不访问真实服务器)。
从抓包创建
在抓包列表对目标请求右键「Mock」,分两步完成配置并保存到 Mock 规则库。
- **第一步 · 拾取特征**:勾选 URL / Query / Body / 请求头及其取值,作为后续请求的匹配条件。
- **第二步 · Mock 篡改**:选择手动或自动 Mock,勾选请求 / 响应阶段,编辑头、体、状态码等。
- 保存后可在「规则 → Mock 配置」中重命名、增删版本或调整启用状态。
第一步:从当前请求勾选 URL、Query、Body 或请求头作为匹配特征。

第二步:选择手动或自动 Mock,配置请求 / 响应篡改内容;自动 Mock 可仅返回预设响应。

匹配逻辑
按抓包里的 URL、参数等匹配;若配置了参数转换,也可按解密后的明文匹配。
多条规则**可同时启用**;按规则列表**从上到下**顺序匹配,**命中第一条即执行**,后续规则不再评估。
手动 Mock 与自动 Mock
手动 Mock
勾选请求 / 响应(可单选或同时选)。命中后暂停并打开**Mock 篡改**弹窗;编辑后点「继续」或「中止」。
若规则包含响应阶段:请求放行后需等待源站响应,再在弹窗里编辑响应内容。
自动 Mock
为当前**生效版本**选择请求或响应之一,并填写篡改内容。命中后**自动放行**。
**仅响应 Mock**:直接返回你配置的响应,**不访问真实服务器**——适合模拟 404、空列表、错误 JSON 等。
篡改版本
每条规则可保存多个「版本」预设(如正常 / 异常响应),但**仅当前选中的生效版本**参与 Mock;切换版本可编辑不同场景,其余版本仅作备选保存。
篡改如何生效
请求头:多行「Header: value」格式,同名头会被覆盖。请求体 / 响应体:篡改区内容**整段替换**原文(不是追加)。响应头:与原有响应头合并,同名键以篡改内容为准。自动 Mock 若篡改区全空,手动模式仍会进入暂停;自动模式则通常不拦截。
启用规则
在 菜单 › 代理 › 启动 Mock → 「启动 Mock」子菜单中勾选要启用的规则(✓ 表示已启用);可一次启用多条。也可在抓包侧栏 Mock 面板或 规则 › Mock 配置 中开关。
须同时开启「代理记录」,新抓到的请求才会进入 Mock 流程;客户端 Tab 的「列表暂停」会让该 IP 的请求跳过 Mock。
Mock 篡改弹窗
手动 Mock 命中后,全屏 **Mock 篡改** 弹窗负责改包;详情区保持只读对照。
- 有待处理项时弹窗自动打开,不可点遮罩或 Esc 关闭;队列清空后自动消失。
- 左侧待处理列表 + 右侧头 / 体编辑器;底部对当前项「继续 / 中止」,以及「全部继续 / 全部中止」。
- 请求与响应两阶段:请求继续后先等待响应,再编辑响应内容。
- 弹窗标题显示待处理数量;切换队列项会同步列表选中与滚动。
连接断开或 Mock 等待超时后,弹窗会关闭并提示被清除的项;详情顶部可能出现灰色说明条,列表行弱化。更细的列表 / 详情联动见抓包界面文档。
加密参数:与明文打交道
接口 Query / Body 若已配置参数转换规则,Mock 篡改弹窗与规则向导中的对应行会**自动解密**并默认展示可编辑明文——你不必手动解码或粘贴密文。
手动 Mock 点「继续」、自动 Mock 放行前,DevPeek 会把修改后的明文**自动加密**回线上格式再发给上游(须在加解密配置中开启重新加密)。Mock 特征拾取与匹配同样基于解密后的明文取值。详见参数转换。
与参数转换一起用
接口参数若加密,先配参数转换,再在 Mock 特征里用解密后的字段。若同时用转发规则,Mock 仍按抓包里的 URL 匹配——详见 Map Route 文档。
排查建议
- Mock 不生效:是否在菜单中启用了规则?是否开启录制?目标客户端是否处于列表暂停?
- 匹配不到:检查特征是否与当前请求一致;参数加密时是否已配置参数转换。
- 自动响应 Mock 仍访问源站:确认生效版本只勾选了响应阶段,且篡改内容非空。
Mock 会直接改变客户端看到的请求 / 响应:在共享环境或非授权目标上使用前请征得同意,并做好回滚预设。