首页/开发/软件测试速查/接口参数边界(分页与范围)
用例设计方法62 条

接口参数边界(分页与范围)

接口参数需要覆盖缺省值、边界值(下界与上界)、越界值、类型错误与未知字段;分页接口重点测 page/size 的 0、1、上限与超大值。

软件测试速查开发更新于 2026-10-13

接口参数边界是什么

接口参数要系统覆盖六类:缺省值(不传参数时的行为)、边界值(下界与上界恰好命中)、越界值(超出上下界一档)、类型错误、未知字段与特殊字符。分页接口是重灾区:page 与 size 的 0、1、上限与超大值都要验证,重点是服务端是否强制上限、越界时返回明确错误,而不是把请求直接砸向数据库。

基本信息

覆盖维度缺省、边界、越界、类型错误、未知字段、特殊字符
分页重点page 的 0 与负数、size 的上限与超大值
安全视角超大 size 可能拖垮数据库,验证服务端强制上限
断言要求错误码、提示信息与数据完整性的多重断言
设计依据等价类与边界值方法在接口参数上的落地

curl 示例

curl 示例
curl -s 'https://api.example.com/items?page=0&size=20'
curl -s 'https://api.example.com/items?page=1&size=100'
curl -s 'https://api.example.com/items?page=1&size=101000'
# 超过上限:预期服务端钳制或返回明确错误,而不是全量查询
curl -s 'https://api.example.com/items?page=-1&size=abc'
# 类型错误:预期 400 与字段级提示

典型使用场景

  • 新接口评审:按六类维度逐项设计参数用例。
  • 分页接口专项:验证默认页大小、上限钳制与空结果页行为。
  • 搜索与排序:非法排序字段、特殊字符关键词的行为验证。
  • 批量接口:一次提交条数上限与超限提示。
  • 数值型参数:精度、正负号与单位换算的边界验证。
  • 安全联动:用超大参数与畸形输入验证资源保护策略。
size 无上限可能导致一次查询拖垮数据库,应验证服务端是否强制上限并返回明确错误。
未知字段的处理策略要显式约定:拒绝(严格)还是忽略(宽容),两种都合理,但实现与文档必须一致。
边界值取三档:恰好在下界、恰好在上界、越界一档;上下界两侧都要覆盖。

易错点

  • 只测正常分页不测超大 size 与负数 page:资源耗尽风险未验证,攻击面留在生产。
  • 忽略未知字段与类型错误的处理策略差异:实现随手忽略或报错,与契约不符。
  • 边界只测一档:上界与下界的另一侧永远没人验证,差一错误流入生产。
  • 分页结果只看状态码:条数与排序稳定性不校验,翻页丢数据无人发现。
  • 特殊字符只测常见符号:空字节、全角、emoji 等极端输入在日志与存储层才爆发。

数据来源与参考

  • RFC 9110(HTTP 语义)
  • OWASP API Security Top 10(资源消耗相关条目)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌