应手动配置page与limit参数测试、用环境变量实现多页轮询、编写tests脚本自动验证；分别用于快速调试、跨页对比和回归测试。
如果您在使用Insomnia测试分页接口时，发现响应数据量过大、页面加载缓慢或无法验证分页逻辑是否生效，则可能是由于未正确配置分页参数、未动态更新页码或缺少断言验证。以下是解决此问题的步骤：
一、手动配置page与limit参数进行基础分页测试
该方法适用于快速验证分页接口是否按预期返回指定页码和数量的数据，无需依赖脚本或环境变量，适合初次调试阶段。
1、点击左上角“+”按钮，选择“New Request”，创建新请求。
2、在URL输入框中输入目标API地址，例如：https://api.example.com/items。
3、切换到“Params”标签页，在查询参数区域添加两行：
page 的值设为 1；
limit 的值设为 10。
4、点击“Send”发送请求，观察响应体中 data 数组长度是否 ≤ 10，且 response.headers 中是否包含 X-Total-Count 或 total 字段用于校验总数。
二、使用环境变量实现多页自动轮询
该方法通过定义可复用的分页变量，配合手动修改 currentPage 值，实现跨页对比与边界值验证，避免重复填写参数。
1、点击左上角“Environment”图标，选择“Manage Environments”。
2、点击“Add Environment”，命名为“Pagination Env”，在变量区域填入：
baseUrl → https://api.example.com
pageSize → 25
currentPage → 1
3、返回请求编辑页，在URL中改写为：{{baseUrl}}/items?page={{currentPage}}&limit={{pageSize}}。
4、发送请求后，手动将 environment 中的 currentPage 改为 2，再次发送，比对两次响应中的 data 内容是否不重叠且无缺失。
三、编写Tests脚本自动验证分页行为
该方法利用Insomnia内置JavaScript引擎，在每次响应后执行断言，确保分页逻辑符合设计规范，适用于回归测试与自动化检查场景。
1、在请求编辑页切换至“Tests”标签。
2、粘贴以下脚本：
const jsonData = response.json();
const limit = parseInt(bruno.env.pageSize || 20);
bruno.assert(jsonData.data.length bruno.assert(jsonData.page === parseInt(bruno.env.currentPage), "响应page字段与请求参数不一致");
3、确保当前已激活“Pagination Env”环境，且 pageSize 和 currentPage 变量已正确定义。
4、点击“Send”，查看右下角Tests面板是否全部通过，失败项将标红显示具体断言错误。
四、处理游标分页（cursor-based pagination）
该方法适用于不支持 page/limit 的接口，如使用 next_cursor、after 或 starting_after 参数的场景，需借助前置脚本注入游标并持久化更新。
1、在请求编辑页切换至“Pre-request Script”标签。
2、输入以下脚本：
const lastCursor = bruno.env.lastCursor || "";
if (lastCursor) {
bruno.request.addParam("cursor", lastCursor);
}
3、切换至“Tests”标签，添加后置断言与游标更新逻辑：
const json = response.json();
const nextCursor = json.next_cursor || json.after;
if (nextCursor) {
bruno.env.set("lastCursor", nextCursor, { persist: true });
}
4、首次运行前清空 lastCursor 环境变量，后续每次发送将自动携带上一次响应中的游标值。
五、使用Collection Runner批量执行分页请求
该方法通过集合运行器一次性发起多个带不同页码的请求，生成结构化响应报告，便于横向对比各页状态码、耗时与数据完整性。
1、将已配置好 page 参数的请求拖入一个新创建的 Collection 中，命名为“Pagination Test Suite”。
2、右键该 Collection，选择“Run Collection”。
3、在 Runner 面板中设置迭代次数为 5，启用“Set iteration data”并上传 CSV 文件，内容示例：
page,limit
1,20
2,20
3,20
4,20
5,20
4、勾选“Save responses”，运行完成后点击“View Report”，检查每轮响应的状态码是否均为200，data.length 是否稳定在20条以内。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
