夜雨聆风
接口断言是接口测试的核心校验手段。发送接口请求后，测试人员将接口返回的实际响应结果，与预设的预期结果进行比对校验，以此判断接口是否符合业务逻辑、返回合格数据。
若无断言，只能人工肉眼查看返回数据，无法自动化判定用例成败。断言是手动接口测试与自动化接口测试的分界标志，也是自动化用例判定结果的必要条件。
1. 自动判定用例：无需人工核对数据，系统自动判断请求成功或失败，提升测试效率。
2. 校验接口准确性：核对状态码、返回字段、数据格式，保证接口符合开发文档规范。
3. 发现隐性缺陷：精准捕捉字段缺失、数据错乱、逻辑异常等不易肉眼发现的bug。
4. 保障迭代稳定：版本迭代后批量回归，防止代码改动破坏原有接口功能。
（一）基础通用断言
适用于所有接口，优先级最高，用于判断接口连通性是否正常。
1. 状态码断言：校验HTTP状态码，例如200请求成功、201新增成功、401权限不足、404接口不存在。
2. 响应格式断言：判断返回数据是否为JSON、XML等规范格式，避免前端解析异常。
3. 响应时间断言：校验接口性能，一般断言响应时间≤500ms，防止接口卡顿超时。
（二）响应体断言
针对响应报文主体校验，是业务测试最常用的断言类型。
1. 关键字断言：判断返回文本是否包含指定关键词，如登录接口校验是否含“登录成功”。
2. 字段存在断言：校验必填字段是否存在，避免字段缺失导致业务报错。
3. 精准值断言：对固定业务数据做精确匹配，例如指定用户ID、订单状态。
4. 长度断言：校验字符串或数组长度，如手机号11位、列表分页条数限制。
（三）高级复杂断言
1. 逻辑关系断言：校验字段间业务逻辑，例如已付款订单的支付金额必须大于0。
2. 数据库断言：接口操作后查询数据库，校验数据是否同步新增、修改或删除。
3. 关联接口断言：串联上下游接口，校验关联数据有效性，如Token能否正常鉴权。
1. 断言优先级：先基础，后业务
优先校验状态码、响应格式，确认接口连通正常后，再校验业务字段，避免无效断言。
2. 断言粒度：粗细适中
不可只断言状态码，也不要校验全部返回字段；只重点断言订单金额、用户ID等核心业务字段，降低维护成本。
3. 区分动态与固定数据
状态码、固定文案使用精准断言；时间戳、随机ID等动态数据使用长度、格式断言。
4. 自定义错误提示
断言失败时标注清晰原因，方便快速定位问题、排查缺陷。
1. 接口异常：服务宕机、地址错误、参数非法。
2. 人为失误：测试人员预期值填写错误。
3. 代码缺陷：开发字段遗漏、数据计算错误。
4. 环境变动：测试环境数据被修改，动态数据未容错。
接口断言是接口自动化测试的核心，本质是比对预期结果与实际响应。测试人员需掌握基础断言、业务断言及常用工具断言写法，遵循优先级分明、粒度适中、适配动态数据的编写原则，精准捕捉bug，稳定维护接口用例，适配企业实际测试工作。
