apifox中需在【后置操作】添加断言实现自动校验:1.状态码校验选http code等于200;2.json字段校验用$.success等于true;3.嵌套字符串校验用$.message等于"success";还可通过自定义脚本灵活校验多字段。

你需要在Apifox中让接口返回结果自动校验是否符合预期,比如状态码是不是200、业务字段success是否为true、message提示是否等于"Success",而不是每次手动翻看响应体逐字比对。
添加断言的入口位置
打开目标接口 → 点击右侧【后置操作】标签页 → 点击【添加后置操作】按钮 → 在弹出菜单中选择【断言】。
注意:断言必须放在【后置操作】里,不能在【前置操作】或请求参数区域设置,否则不会执行校验逻辑。
用图形化方式快速配置3个常用断言
方法一:状态码校验
点击【添加断言】→ 断言名称填“状态码 200” → 断言对象选【HTTP Code】→ 比较方式选【等于】→ 预期值填【200】。
方法二:JSON字段值校验
点击【添加断言】→ 断言名称填“操作成功” → 断言对象选【Response JSON】→ 路径/方式填【$.success】→ 预期值填【true】(不加引号)。
方法三:嵌套字段字符串校验
点击【添加断言】→ 断言名称填“提示信息正确” → 断言对象选【Response JSON】→ 路径/方式填【$.message】→ 预期值填【"Success"】(必须带英文双引号,否则校验失败)。
Apifox是一款拥有可视化管理界面的接口开发调试工具,支持接口调试,自动校验数据结构,自动化测试等功能,能够帮助用户更好的测试API,能够有效提高团队的办公效率,有需要的用户欢迎下载使用!功能介绍可视化接口管理方便快捷可视化接口管理,成倍提升团队多人协作效率。支持数据结构(JSON Schema)管理,多接口可复用相同数据结构。接口调试Postman 有的功能,比如环境变量、预执行脚本、后执行脚本、Cookie/Session 全局共享 等功能,Apifox 都有,并且和 Postman 一样高效好用。
用自定义脚本写更灵活的断言
第一步:切换到【后置操作】→ 点击【添加后置操作】→ 选择【自定义脚本】。
第二步:粘贴以下代码(直接复制即可,无需修改):
// 验证HTTP状态码
// 验证业务字段code是否为200
// 验证message是否包含"Success"
pm.test("Status code is 200", () => {
pm.response.to.have.status(200);
});
pm.test("Business code is 200", () => {
const jsonData = pm.response.json();
pm.expect(jsonData.code).to.equal(200);
});
pm.test("Message contains Success", () => {
pm.expect(pm.response.text()).to.include("Success");
});
这三段脚本会分别校验状态码、JSON中的code字段、响应体文本是否含指定字符串。其中【pm.response.json()】要求响应体必须是合法JSON格式,否则脚本会直接报错中断执行。
动态提取并校验多个字段值
适用场景:你不知道接口返回的字段名是data还是result,或者字段层级可能变化,但总有一个非空数值字段需要校验。
在【自定义脚本】中写入:
const res = pm.response.json();
const keys = Object.keys(res);
for (let key of keys) {
if (typeof res[key] === 'number' && res[key] > 0) {
pm.test(`字段 ${key} 是正数`, () => {
pm.expect(res[key]).to.be.above(0);
});
break;
}
}
这段脚本会遍历第一层所有键,找到第一个类型为number且大于0的值,立即对该字段做断言并退出循环。它不依赖固定路径,适合字段结构不稳定的测试场景。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










