Postman怎么传分页页码_Postman分页查询参数配置教程

千枫同学_4441

千枫同学_4441

2026-11-07

253人浏览

原创

Postman调用Spring Boot分页接口需严格按后端@RequestBody或@RequestParam定义的参数名(如page/pageSize、currentPage/limit等)在Params或Body中填写,错一个字母或类型不匹配即失效。

postman怎么传分页页码_postman分页查询参数配置教程

Postman 传分页参数不需要特殊配置,只要按后端约定把 page 和 pageSize(或 size、limit)作为 Query 参数填对就行——但错一个字母、少一个默认值、或参数名不匹配,就直接查全表或返回空。

Postman 中怎么填分页 Query 参数

绝大多数 Spring Boot 分页接口用的是 GET 请求,参数走 URL 查询字符串。比如后端定义了:

@GetMapping("/emps")
public Result page(@RequestParam(defaultValue = "1") Integer page, @RequestParam(defaultValue = "10") Integer pageSize)

那你在 Postman 就得这样填:

  • 请求方法选 GET
  • URL 写完整地址,例如 http://localhost:8080/emps
  • 点击 Params 标签页,在表格里手动加两行:
    – Key 填 page,Value 填 2
    – Key 填 pageSize,Value 填 15
  • 最终发出的请求 URL 会自动拼成:http://localhost:8080/emps?page=2&pageSize=15

别手抖写成 Page 或 pages,大小写和复数都可能让后端收不到值,触发 defaultValue(比如默认查第 1 页),但你完全意识不到。

为什么传了参数却没分页?常见参数名冲突

不同框架/团队对分页参数命名不统一,Postman 里填错名字等于白填。后端可能实际认的是这些组合之一:

  • page + limit(如若依、部分 MyBatis-Plus 项目)
  • currentPage + pageSize(某些自定义 PageBean 封装)
  • start + size(MyBatis-Plus Page(start, size) 构造器常用)
  • pageNum + pageSize(PageHelper 默认习惯)

判断依据只有一个:看后端 Controller 方法的 @RequestParam 名字,或者翻接口文档。如果文档没写,就去扒代码里的形参名——page 和 pageSize 是最常见,但不是唯一。

Postman 12.27.7
Postman 12.27.7

Postman 12.27.7 Windows x64 官方安装包,适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力,以及接口规范标签管理改进,适合受限网络测试与规范资源组织场景。

下载

POST 请求带分页参数怎么传

有些接口强制用 POST(比如要连带复杂查询条件),这时分页参数不能放 URL,得进 body:

  • 请求方法选 POST
  • URL 只写路径,例如 http://localhost:8080/emps/list
  • Body 选 raw → 类型选 JSON
  • 填入类似这样的 JSON:
{
  "page": 3,
  "pageSize": 20,
  "name": "张三",
  "status": 1
}

⚠️ 注意:这要求后端 Controller 用 @RequestBody 接收一个封装对象(比如 PageQuery),且该对象里必须有 page 和 pageSize 字段。如果后端还是用 @RequestParam,那 POST body 里的分页字段根本不会被绑定——你会拿到第 1 页数据,还找不到原因。

Postman 调试时容易忽略的细节

分页接口看似简单,但几个隐性坑常导致“明明传了却没生效”:

  • 后端用了 PageHelper 但没配 support-methods-arguments: true,那就只能靠 ThreadLocal 的 startPage(),无法从接口参数自动识别分页——此时 Postman 传什么都没用
  • 前端调试时开了浏览器缓存,Postman 换了参数但响应还是旧的;建议在 Postman Headers 加 Cache-Control: no-cache
  • 响应里没返回 total 字段,或者前端把 total 解析成字符串而非数字,会导致分页组件算错总页数
  • 用 Collection Runner 批量跑分页接口时,若没设好变量迭代逻辑,所有请求可能都发了 page=1

真正卡住人的往往不是“怎么传”,而是“传了之后后端到底有没有收到、有没有进分页逻辑”。最稳的办法:在 Controller 入口加个 log.info("page={}, pageSize={}", page, pageSize),一眼看清参数是否落地。

相关专题

更多
软件测试常用工具
软件测试常用工具

软件测试常用工具有Selenium、JUnit、Appium、JMeter、LoadRunner、Postman、TestNG、LoadUI、SoapUI、Cucumber和Robot Framework等等。测试人员可以根据具体的测试需求和技术栈选择适合的工具,提高测试效率和准确性 。

2023.10.13

5090

8

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

0

12

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

2026.11.06

0

13

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

2026.11.06

0

10

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

2026.11.05

20

12

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

2026.11.05

20

12

DBeaver连接创建与配置教程
DBeaver连接创建与配置教程

本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。

2026.11.04

20

16

XORM框架结构体映射与表结构同步
XORM框架结构体映射与表结构同步

本专题围绕XORM框架的结构体映射展开,说明表名与字段的命名策略、xorm标签常用属性、主键自增与时间字段自动填充,并演示Sync2自动建表、增量字段升级、索引声明与反向生成结构体的完整流程。

2026.11.04

20

15

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

2026.11.04

20

15

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Postman Native Git工作流指南
Postman Native Git工作流指南

共0课时 | 0人学习

Postman Vault密钥管理指南
Postman Vault密钥管理指南

共0课时 | 0人学习

Postman集合运行器使用指南
Postman集合运行器使用指南

共0课时 | 0人学习