测试接口传参数时,放在Header和Body中后台接收参数的区别

Post 请求:参数放 Header / Body 后端接收区别(SpringBoot)

一、参数放在 Header(请求头)

1、取值注解:@RequestHeader

java 复制代码
@PostMapping("/header")
public String getHeader(@RequestHeader("token") String token) {
    return token;
}
  • 位置:Postman → Headers 面板填 key=value
  • 特点
  1. 不属于请求体,和 GET/POST 无关,GET 也能在 Header 带参
  2. 无法传复杂对象、数组,只适合短字符串(token、appId、版本号)
  3. 不会被@RequestBody读取,和 Body 参数互不干扰
  4. 参数不在 url、不在 body,抓包在请求头字段

二、参数放在 Body(请求体)分两种格式

① Body → x-www-form-urlencoded(表单格式)

取值:@RequestParam

java 复制代码
@PostMapping("/form")
public String getForm(@RequestParam("name") String name) {
    return name;
}
  • Postman:Body→x-www-form-urlencoded,键值对
  • 底层:表单拼接name=xx&age=18,放到请求体
  • 不能用 @RequestBody 接收

② Body → raw-JSON(最常用)

取值:@RequestBody(整个 body 封装成对象)

java 复制代码
@PostMapping("/json")
public String getJson(@RequestBody User user) {
    return user.getName();
}
  • Postman:Body→raw→JSON {"name":"张三"}
  • 规则:
  1. @RequestBody一次性读取整个 Body 流,一个接口只能出现一次
  2. 不能搭配@RequestParam拿 body 里字段
  3. 支持对象、数组、嵌套复杂结构

三、核心对比汇总

位置 取值注解 数据格式 适用场景
Header @RequestHeader 单个字符串 token、鉴权、设备信息
Body 表单 @RequestParam key=val&key=val 简单键值、老表单提交
Body JSON @RequestBody JSON{}/\[\] 前后端分离、复杂入参

四、高频踩坑

  1. JSON 参数放 Body,却用 @RequestParam:拿不到值,报参数缺失
  2. Header 参数用 @RequestBody:拿不到,RequestBody 只读 body
  3. 一个接口:@RequestHeader(头) + @RequestBody(体) 可以共存,互不冲突
相关推荐
西西弗Sisyphus27 分钟前
C++ explicit 关键字工程实践
开发语言·c++
Forget the Dream1 小时前
Spring AI 2.0 系列(二):第一个 ChatClient——从注入到一次完整调用
java·人工智能·spring boot·ai·springai
郝学胜-神的一滴2 小时前
Effective Python 条款35:用类封装替代生成器异常注入
开发语言·人工智能·python·金融·pandas·scikit-learn·matplotlib
火山引擎和TA的超级拍档们2 小时前
产品情报局 11 | AI 数据湖 LAS:打造大模型时代多模态数据底座
前端·后端
JavaGuide2 小时前
Gemini 真的变强了,写代码做视频的能力接近 Claude Opus5.5 了!
前端·ai编程
niceyayale2 小时前
WebRTC 延迟怎么调试:从 ICE 到 jitter buffer 的六个观测点
前端
aleimu2 小时前
Windows 11 右键打开 Cmder 2.0:从找不到菜单到默认使用 Cmder
前端·人工智能·后端
tryCbest2 小时前
Vue系列——第 20 篇:Vue Router 4——路由管理完全指南(上)
前端·javascript·vue.js
feixing_fx2 小时前
原始类型与引用类型:赋值时到底复制了什么
开发语言·前端·javascript·前端框架
wuyk5552 小时前
Python办公自动化-第02讲-Excel文件认知与四大库选型
开发语言·python·excel