SpringBoot传递单一参数时@RequestParam和@RequestBody的区

用SpringBoot框架做项目时，经常需要前端给后端传递参数，如果需要多条参数，通常的做法是把这些参数封装为一个对象来传递，前端用POST方式调用。但有时会遇到后端只需要一条参数（比如一个String）的情况，此时如果还封装为一个对象，有些麻烦；最好的办法是用GET方式调用，直接把参数拼接在url后面。然而，一般项目都有统一的接口规范，要求接口都要用POST方式，此时就遇到一个问题：controller方法上到底是用@RequestParam注解还是用@RequestBody注解？



 之前对这两个注解的区别，只有一个粗枝大叶的理解——@RequestParam针对单一的参数，而@RequestBody针对多个参数封装为一个对象，问了身边几个同事，大概也都是这种理解。但是，实际测试中（使用Postman），当我用@RequestParam接受String的单一参数时，前端给我传递的参数却接收不到。于是决定通过实验，彻底搞明白二者的区别（针对单一参数、且规定使用POST方式的场景）。实验的过程是分别用两个注解去接受前端传递的一个名为content的String。



实验一：使用@RequestParam注解



Controller方法代码：（省略其他部分以及返回值Result代码）



@RequestMapping(value="/requestParam", method= RequestMethod.POST, produces = "application/json;charset=UTF-8")

public Result<String> requestParam(@RequestParam("content") String content) {

System.out.println("content:"+content);

return success(new Result<String>(), content);

现在我用postman来测试几种可能的参数传递方式：



1. 在Body的raw里面传递，也是最通常的传参方式：



body-raw



结果是接收不到（不管是用text还是json等各种文本形式）！



 { "timestamp": 1544798083474,

    "status": 400,

    "error": "Bad Request",

    "exception": "org.springframework.web.bind.MissingServletRequestParameterException",

    "message": "Required String parameter 'content' is not present",

    "path": "/testParam/requestParam"

  }



2. 在Headers里通过key-value的形式传递。这是网上一些帖子里说的方式。



Headers方式



但结果还是接收不到！和上面一样报错400。



关于这一点，网上有些帖子里说@RequestParam的参数会写到Headers里，可见是错误的，并非在Headers里，还是在Body里。



3. 在Body的form-data里通过key-value的形式传递，可以接收！



form-data



但是，前端在传参时，是无法向这个form-data里传递参数的，所以这种方法可以被排除。



4. 在url后问号拼接参数。和很多人一样，之前一直根深蒂固地认为只有GET方式才能用url问号传参，POST方式不行，但事实证明在这里问号传参POST方式同样能接收到。如图：



问号传参



虽然能接受到参数，但前端也有统一的规范，一般不使用问号传参的方式，所以这种方法也被排除。



实验二：使用@RequestBody注解



@RequestMapping(value="/requestBody", method= RequestMethod.POST, produces = "application/json;charset=UTF-8")

public Result<String> requestBody(@RequestBody String content) {

System.out.println("content:"+content);

return success(new Result<String>(), content);

}

 既然是Body，自然不能在header里传参，也不能在url里问号传参。至于Body的form-data，经测试也无效。所以，这里只有唯一一种方式，就是将参数直接写在Body的raw模式下，可以接收到，而且最好选择Text而非JSON(application/json)，如图：



body



 注意：这里body体里面传什么内容，后台就会原样接收，所以不要写成content: XXX这种键值对形式，而应直接把String的内容写在body体里。



 总结：



对于传递单一参数（最典型的是String）的场合，最简便的方法是用GET请求。但鉴于很多项目接口统一要求使用POST方式，此时不能使用@RequestParam方式，因为此方式前端传递的参数后端无法接收；而只能采用@RequestBody注解，直接将需要的参数内容写入Body体，后端即可正常获取！

原文地址：https://bbs.csdn.net/topics/392660349