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

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-PlusPage(start, size)构造器常用) -
pageNum+pageSize(PageHelper 默认习惯)
判断依据只有一个:看后端 Controller 方法的 @RequestParam 名字,或者翻接口文档。如果文档没写,就去扒代码里的形参名——page 和 pageSize 是最常见,但不是唯一。
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),一眼看清参数是否落地。










