CodeBuddy接口调试怎么配置沙箱提升安全性

先说几个核心判断：在CodeBuddy中调试接口，最怕的就是误操作触发了真实的生产环境——订单生成、扣款执行、消息推送，这些都是不可逆的。必须用沙箱把测试流量和真实系统彻底隔离开。

具体怎么做？

启用内置沙箱模式

第一步，打开CodeBuddy的左侧导航栏，找到【API调试】，进入当前项目的接口列表。

第二步，在目标接口右侧操作栏，点击「调试」按钮。页面顶部会出现一个环境选择下拉框，默认是「生产」。

第三步，把这个环境切换成

。切换后，所有请求都会自动路由到预置的隔离网关。想确认是否生效？看响应体里的data字段，它会携带一个"sandbox_mode": true的标识——有就对了。

这里有个关键点：沙箱模式只对已经接入CodeBuddy沙箱网关的接口有效。如果接口本身没配置沙箱路由，切换了也不会报错，但实际走的是默认通道，没有隔离性。

手动注入沙箱Header

除了切换环境，还可以手动给请求打上沙箱标记。有两种方式。

：在请求Headers区域添加一组键值对——是X-CodeBuddy-Env，写sandbox。

：如果你用的是Bearer Token认证，必须确保这个Token是由沙箱授权中心签发的。生产环境的Token在沙箱里会被直接拒绝，返回403，附带"reason": "token_not_valid_in_sandbox"提示。

这一步不能省略：沙箱Header必须在请求发送前设置完成。如果你中途改了Header再重发请求，旧的请求仍然按原来的环境执行——

。

绑定沙箱Mock规则

进入该接口的「Mock配置」页签，点击「新建规则」。规则类型选择「沙箱专用」，然后在「匹配条件」里填写headers.X-CodeBuddy-Env === "sandbox"。

接着，在响应模板里可以自由定义JSON结构。比如模拟支付成功但金额固定为0.01元，或者返回特定错误码来模拟风控拦截。

关键点：只有当请求同时满足「环境为沙箱」和「命中此Mock规则」两个条件，才会返回Mock数据。否则，会回退到真实后端（前提是沙箱网关没有拦截）。