Apifox断言配置教程

轻敏君_1221

轻敏君_1221

2026-06-23

487人浏览

原创

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

apifox断言配置教程 - php中文网

你需要在Apifox中让接口返回结果自动校验是否符合预期,比如状态码是不是200、业务字段success是否为true、message提示是否等于"Success",而不是每次手动翻看响应体逐字比对。

添加断言的入口位置

打开目标接口 → 点击右侧【后置操作】标签页 → 点击【添加后置操作】按钮 → 在弹出菜单中选择【断言】。

注意:断言必须放在【后置操作】里,不能在【前置操作】或请求参数区域设置,否则不会执行校验逻辑。

用图形化方式快速配置3个常用断言

方法一:状态码校验

点击【添加断言】→ 断言名称填“状态码 200” → 断言对象选【HTTP Code】→ 比较方式选【等于】→ 预期值填【200】。

方法二:JSON字段值校验

点击【添加断言】→ 断言名称填“操作成功” → 断言对象选【Response JSON】→ 路径/方式填【$.success】→ 预期值填【true】(不加引号)。

方法三:嵌套字段字符串校验

点击【添加断言】→ 断言名称填“提示信息正确” → 断言对象选【Response JSON】→ 路径/方式填【$.message】→ 预期值填【"Success"】(必须带英文双引号,否则校验失败)。

用自定义脚本写更灵活的断言

第一步:切换到【后置操作】→ 点击【添加后置操作】→ 选择【自定义脚本】。

Apifox(Linux)
Apifox(Linux)

Apifox Linux 桌面版是一款专为 Linux 开发者打造的 API 一体化工具,集接口设计、调试、测试、Mock 和文档管理于一体。它在 Linux 环境下提供稳定、高效的本地运行体验,帮助开发者实现 API 全生命周期管理,是 Linux 开发者进行接口开发与联调的高效工具。

下载

第二步:粘贴以下代码(直接复制即可,无需修改):

// 验证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应用能力赋能!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

apifox

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Apifox接口调试教程大全
Apifox接口调试教程大全

Apifox接口调试专题覆盖 HTTP 请求发送、请求头、Query参数、Body请求体、Cookie、鉴权、响应校验、前置脚本、后置脚本和接口用例管理,帮助开发和测试人员在同一工具中完成接口调试、问题定位和前后端联调,减少 Postman 与文档工具之间的数据重复维护。

2026.06.23

609

10

Apifox自动化测试教程
Apifox自动化测试教程

Apifox自动化测试专题围绕接口测试场景编排、测试步骤、断言、变量提取、数据驱动、数据库校验、测试报告和 Apifox CLI 持续集成展开,适合测试工程师和研发团队构建 API 回归测试流程,并与 Jenkins、GitLab CI 等流水线结合提升接口质量保障效率。

2026.06.23

665

10

Apifox迁移协作指南
Apifox迁移协作指南

Apifox迁移协作专题覆盖 Swagger、OpenAPI、Postman、YApi、Eolink、Knife4j、HAR 等数据导入导出,讲解团队权限、项目成员、接口变更同步、数据备份、私有化部署和企业协作管理,适合从旧接口工具迁移到 Apifox 的团队规划统一 API 管理平台。

2026.06.24

602

10

Tailwind CSS 如何制作导航栏和卡片
Tailwind CSS 如何制作导航栏和卡片

用 Tailwind CSS 制作导航栏和卡片,可先搭建语义化结构,再组合 Flex、Grid、间距、圆角与阴影类。这里整理横向导航、移动端菜单、卡片网格及悬停效果的相关文章,帮助你把常见页面组件做得清晰且适配不同屏幕。

2026.11.03

0

17

Tailwind CSS 响应式布局怎么写
Tailwind CSS 响应式布局怎么写

Tailwind CSS 响应式布局通常从移动端样式写起,再用 sm、md、lg 等前缀调整不同屏幕宽度下的网格、间距和导航。本专题整理断点配置、Grid 与 Flex 自适应布局及常见溢出问题,帮助你逐步完成多设备适配。

2026.11.03

0

19

Tailwind CSS 常用类名怎么记
Tailwind CSS 常用类名怎么记

Tailwind CSS 类名很多,先按布局、间距、文字、颜色和状态分组记忆,再通过官方文档检索具体写法。本专题结合类名排序、动态拼接失效、自定义实用类等问题,帮助你建立常用类名的速查方法。

2026.11.03

0

12

码上飞入口地址合集
码上飞入口地址合集

本专题汇总了码上飞(CodeFlying)的官方入口地址合集,涵盖官网主站及网页版在线使用入口,支持注册登录后直接在线体验零代码AI应用生成。同时整理了APP端下载渠道与小程序入口,助你快速访问平台,通过自然语言描述需求即可生成应用、小程序或网站。

2026.11.03

0

10

Uvicorn 报错与问题解决教程
Uvicorn 报错与问题解决教程

本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集,涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案,助你快速定位并解决Uvicorn运行中的各类问题。

2026.11.02

20

14

Uvicorn使用教程
Uvicorn使用教程

本专题汇总了Uvicorn使用教程与启动运行指南,涵盖其作为Python ASGI服务器的定位与特点,以及命令行启动(uvicorn main:app --reload)、参数配置(host/port/workers)、程序内嵌运行与Gunicorn结合部署等核心用法。同时整理了热重载调试、日志配置与生产环境部署优化等技巧,助你快速掌握Uvicorn的运行与配置。

2026.11.02

20

17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Apifox CLI官方手册
Apifox CLI官方手册

共0课时 | 0人学习

Apifox下载与安装手册
Apifox下载与安装手册

共0课时 | 0人学习

Apifox官方手册
Apifox官方手册

共0课时 | 0人学习