httpCanary 中文文档 下载 App

静态注入:预设规则自动改包

静态注入是什么

静态注入就是创建一条「规则」——定义好「遇到什么请求时触发修改」以及「具体改什么」,之后所有匹配该规则的请求都会自动被修改,全程不需要人工干预。

创建步骤

第一步:找到入口

有两种方式进入静态注入配置界面:

方式 A:从已有请求创建(推荐)

在请求列表中 长按 某条请求,在弹出的菜单中选择「静态注入」。这样会自动把该请求的匹配条件预填好,你只需要配置修改内容。

方式 B:从设置菜单新建

设置 → 注入器 → 点击「+」创建新的注入器,手动填写匹配条件。

第二步:配置匹配条件

注入器需要定义「什么时候触发」——即这条规则应该匹配哪些请求:

条件说明示例
Host匹配目标域名api.example.com
URL 路径匹配 URL 路径模式/api/user/* 或 /api/user/info
请求方法GET/POST 等只匹配 POST 请求
请求头匹配特定 HeaderContent-Type: application/json
应用匹配发起请求的 App只匹配微信发起的请求

多个条件之间可以是 AND 也可以是 OR 关系,根据实际需求组合。

第三步:配置修改规则

匹配条件定义好后,配置「具体改什么」。注入器分为请求侧和响应侧两部分,可以同时配置或只配一侧:

请求侧修改:

修改项说明
请求 URL可以改路径、查询参数
请求方法GET/POST 之间切换
请求头增加、删除、修改 Header
请求参数Form 参数的增删改
请求体Body 内容替换

响应侧修改:

修改项说明
响应状态码比如把 200 改成 500 测试异常处理
响应头增加、删除、修改 Header
响应体整体替换(上传文件或粘贴文本)或部分字段修改

第四步:保存并启用

配置完成后保存注入器,状态默认为「启用」。之后所有匹配条件的请求都会自动应用修改。

静态注入配置界面
静态注入器配置界面

多注入器同时生效

静态注入支持创建多个注入器并同时启用。这意味着:

这让复杂场景变得灵活——比如你可以同时开「给所有请求加个 Header」和「给特定接口改响应体」两个注入器。

实战例子

例子一:测试客户端对异常响应的处理

目标:让某个正常接口返回 500 错误,看客户端会不会崩溃或显示友好提示。

  1. 从请求列表长按该接口 → 静态注入
  2. 响应侧 → 修改状态码 → 原状态码填 200,改后填 500
  3. 保存启用
  4. 重新在 App 里触发这个接口,观察客户端行为

例子二:修改响应体字段值

目标:把商品库存从 0 改成 100,看客户端是否允许下单。

  1. 从请求列表长按该接口 → 静态注入
  2. 响应侧 → 「跟随服务器」旁边点编辑图标
  3. 在 Body 中找到 inventory: 0,改成 inventory: 100
  4. 保存启用
  5. 刷新 App 商品详情页,尝试下单
响应注入编辑
编辑响应体内容替换服务器返回的数据

例子三:给请求加自定义 Header

目标:模拟服务端需要的某个 Header 字段,看加了之后是否能正常通过。

  1. 新建注入器
  2. 匹配条件:Host 填目标域名
  3. 请求侧 → 增加 Header → 名称 X-Custom-Token,值 test123
  4. 保存启用

注意事项