三大传参注解完整详解

一、@RequestParam(你项目绝大多数接口在用,form 表单 / URL 查询参数)

1. 接收数据来源

两种数据载体:

  1. GET 请求:URL ? 后面拼接的键值对 例:/actionmall/product/findproducts.do?pageNum=1&pageSize=10
  2. POST 表单提交:Content-Type: application/x-www-form-urlencoded(你 JMeter 所有接口都是这个类型) 表单体:account=zhangsan&password=123456

2. 核心属性

java

复制代码
// 完整写法
@RequestParam(
    value = "前端参数名",
    required = true,       // 是否必传,不传直接400报错
    defaultValue = "1"      // 参数缺失时默认值,自动使required=false
)
  • required=true(默认):压测时 JMeter 漏传该参数,直接返回 400,计入错误率(你 20%/50% 报错核心诱因)
  • defaultValue:兜底,分页、ID 类参数推荐配置,减少压测失败

3. 多值 / 数组接收(购物车批量结算场景)

前端传:cartIds=1&cartIds=2&cartIds=3

java

复制代码
// 直接接收集合
public Result createOrder(@RequestParam List<Long> cartIds)

4. 适用场景

你的全量前台、后台、支付回调接口全部适配; 不能接收 JSON 字符串,如果前端传 JSON,用这个注解会接收不到任何数据。

5. JMeter 匹配示例

plaintext

复制代码
POST /actionmall/user/do_shturl.c
Content-Type: application/x-www-form-urlencoded
account=zhangsan&password=123456&captchaKey=test

后端接收:

java

复制代码
@RequestMapping("/user/do_shturl.c")
public Result login(
    @RequestParam String account,
    @RequestParam String password,
    @RequestParam String captchaKey
)

二、@RequestBody(接收 JSON 请求体,表单接口完全不兼容)

1. 接收数据来源

请求请求体完整 JSON 字符串 ,要求请求头:Content-Type: application/json 请求体示例:

json

复制代码
{
  "productId": 1,
  "quantity": 2
}

2. 核心特性

  1. 只能有一个 @RequestBody 注解,整个请求体只能绑定一个实体类;
  2. 自动 JSON 序列化 / 反序列化,底层依赖 Jackson;
  3. 完全不识别 form 表单、URL 问号参数,混用直接参数为空、400 报错。

3. 代码示例

java

复制代码
// 实体类
public class CartDTO {
    private Long productId;
    private Integer quantity;
}

// Controller
@RequestMapping("/cart/add")
public Result addCart(@RequestBody CartDTO cartDTO) {
    // 自动把JSON映射到CartDTO对象
}

4. 和你现有压测冲突点

你当前 JMeter 全部是application/x-www-form-urlencoded表单,如果后端接口写了@RequestBody,所有请求参数全部接收失败,错误率 100%。

改造方式:JMeter 请求头改为application/json,请求体切换为 Raw JSON。


三、@PathVariable(提取 URL 路径中的动态变量,无请求参数)

1. 接收数据来源

从URL 路径本身 截取变量,不是问号、不是表单、不是 JSON。 URL 示例:/actionmall/product/detail/{productId} 这里 {productId} 就是路径变量。

2. 代码示例

java

复制代码
@RequestMapping("/product/detail/{productId}")
public Result getDetail(@PathVariable Long productId) {
    // productId 从URL路径中提取
}

访问地址:/actionmall/product/detail/1 → productId=1

3. 多路径变量

java

复制代码
@RequestMapping("/order/{orderNo}/log/{logId}")
public Result log(@PathVariable String orderNo, @PathVariable Long logId)

4. 关键限制

  1. 仅解析路径占位符,拿不到表单、URL 后的?参数;
  2. 没有required、defaultValue属性,路径缺少占位符直接 404 页面不存在;
  3. 适合 RESTful 风格接口,你当前电商项目几乎没有这类接口。

四、三者核心对比表(一目了然)

表格

注解 数据源 对应 Content-Type 典型传参格式 你的项目适配度
@RequestParam URL? 参数 /form 表单 application/x-www-form-urlencoded key=val&key2=val2 极高(全部现有接口)
@RequestBody 请求体 JSON application/json {"key":val} 低(无现有接口)
@PathVariable URL 路径占位符 无要求,不依赖请求体 /xxx/{id} 极低

五、结合你压测报错的避坑重点

  1. 不要混用 @RequestBody 和表单 后端接口写了@RequestBody,但 JMeter 用表单传参 → 参数全部为空,大量 400 错误;

  2. @RequestParam 的 required=true 是报错重灾区 分页、地址 ID、验证码等参数如果漏传,直接失败,建议分页加defaultValue="1"兜底;

  3. @PathVariable 不存在默认值 如果路径变量缺失,不会进入接口方法,直接 404,无法通过注解兜底;

  4. 同一接口可以同时使用 @RequestParam + @PathVariable 例:/product/{id}?page=1

    java

    复制代码
    public Result test(@PathVariable Long id, @RequestParam Integer page)
相关推荐
火云代理4 天前
同一个网站,有的网络能打开、有的打不开?认识 IPv4 与 IPv6 的访问差异
服务器·网络·网络协议·tcp/ip·测试工具·php·状态模式
FungLeo6 天前
成为全栈·Vue 管理后台篇·分页只显示第一页:从接口total 定位到前端修复
前端·vue.js·状态模式·分页·naive ui·服务端分页·前端问题排查
严肃小白兔8 天前
TanStack Router 更新构建工具链:Node.js 兼容性、路由分割与前端工程实践
前端·node.js·状态模式
大江东去浪淘尽千古风流人物17 天前
【HexVIO】DSP卸载双目惯性VIO:Hexagon向量化前端与单帧融合调度深度解析
前端·状态模式·slam·dsp·vio·hexagon·移动端加速
吃一碗粉只付一碗钱17 天前
12-给SPA友好的401和403响应
c#·状态模式
sunlifenger18 天前
嵌入式部署,解锁张家港智慧灯杆的“极简组网”密码
科技·状态模式
上火的金鱼妹19 天前
关于多进程sse连接通知的实战
javascript·状态模式·sse
阿俊-全栈开发19 天前
LikeShop 小程序商城首页可配置弹窗的设计与实现(Java + uni-app)
小程序·状态模式·likeshop·likeshop开源商城
lingyubb19 天前
配音工具怎么选?从 TTS 合成链路看 6 个可量化参数
状态模式