SpringBoot请求参数接收控制指南分享

更新时间：2025年04月25日 14:42:00 作者：L_！！！

这篇文章主要介绍了SpringBoot请求参数接收控制指南,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教

Spring Boot 请求参数接收控制指南

1. 概述

在Spring Boot项目中，我们可以通过不同的注解来接收来自HTTP请求的各种参数。

本指南将详细介绍各种参数接收方式及其使用场景。

2. 有注解时参数接收方式对比

参数类型	注解	位置	适用HTTP方法	示例
路径参数	@PathVariable	URL路径中	GET, DELETE	/users/{id}
查询参数	@RequestParam	URL?后	GET	/users?name=John
请求体	@RequestBody	请求体	POST, PUT, PATCH	JSON/XML数据
请求头	@RequestHeader	HTTP头	任意	Authorization: Bearer token
Cookie值	@CookieValue	Cookie头	任意	Cookie: JSESSIONID=xxx
表单数据	@RequestParam	表单体	POST	application/x-www-form-urlencoded
文件上传	@RequestParam	multipart/form-data	POST	文件上传表单

3. 无注解时接收参数默认位置

Spring Boot 默认参数绑定规则（不加注解时）

请求类型	参数类型	默认绑定位置	示例	注意事项
GET	基本类型/String	自动绑定到URL查询参数	GET /user?name=Tom → public String getUser(String name)	参数名必须与URL中的key一致
	POJO对象	自动绑定到URL查询参数	GET /user?name=Tom&age=20 → public String getUser(User user)	对象的字段名需与URL参数匹配
	数组/集合	自动绑定到URL查询参数	GET /user?ids=1,2,3 → public String getUser(List<Integer> ids)	支持逗号分隔或同名参数（ids=1&ids=2）
POST	基本类型/String	表单数据 (Form Data)	POST /user (Content-Type: application/x-www-form-urlencoded)	需设置Content-Type为表单类型
	POJO对象	表单数据或JSON请求体	若为application/json → 绑定到请求体；若为表单 → 按字段名匹配	需明确指定Content-Type，否则可能解析失败
	数组/集合	表单数据或JSON请求体	同POJO规则	表单格式需用同名参数（names=Tom&names=Jerry）
	MultipartFile	文件上传 (multipart)	POST /upload (enctype="multipart/form-data")	必须设置enctype="multipart/form-data"
PUT/PATCH	所有类型	JSON/XML请求体	PUT /user { "name": "Tom" } → public String updateUser(User user)	默认按@RequestBody处理，需显式加注解才能覆盖
DELETE	基本类型/String	URL查询参数	DELETE /user?id=123 → public String deleteUser(Long id)	与GET相同
	POJO对象	不支持	-	DELETE通常只用路径参数或简单查询参数

关键规则总结

GET/DELETE 请求：

参数默认绑定到 URL查询字符串（?key=value）。
POJO对象会按字段名自动拆解到查询参数。

POST 请求：

默认按 表单数据（application/x-www-form-urlencoded）解析。
若请求头为 Content-Type: application/json，则需显式加 @RequestBody，否则绑定失败。

PUT/PATCH 请求：

默认按请求体（JSON/XML）处理，类似@RequestBody行为，但实际开发中建议显式加注解。

特殊类型：

MultipartFile：仅在 multipart/form-data 类型的POST中自动绑定。
数组/集合：支持URL查询参数（GET）或表单同名参数（POST）。

常见误区澄清

表单数据不会放在请求头

请求头仅用于元数据（如Content-Type、Authorization等），表单内容一定在请求体。

GET请求能否带表单数据？

❌ 不能。GET请求的参数只能通过URL查询字符串（?key=value）传递，且长度受限。

不加注解时Spring Boot如何绑定表单数据？

默认按参数名匹配请求体中的表单字段（需参数名与表单字段名一致）。

POST JSON vs 表单数据

JSON数据必须显式使用@RequestBody，而表单数据默认绑定（无需注解）。

4.HTTP请求参数位置自定义控制对照表

参数位置	Spring Boot注解	手动提取方式	适用场景	示例请求
URL路径参数	@PathVariable	HttpServletRequest.getRequestURI()	RESTful资源标识	GET /users/123 → id=123
URL查询参数	@RequestParam	request.getParameter("name")	过滤条件、分页	GET /users?name=Tom → name=Tom
请求头	@RequestHeader	request.getHeader("Authorization")	认证令牌、客户端信息	Header: Authorization: Bearer xxx
请求体（JSON）	@RequestBody	InputStream + JSON解析库	复杂数据提交	POST /users + {"name":"Tom"}
请求体（表单）	@RequestParam	request.getParameterMap()	传统表单提交	POST /login + username=Tom&password=123
请求体（文件）	@RequestPart	MultipartHttpServletRequest	文件上传	POST /upload + multipart/form-data
Cookie	@CookieValue	request.getCookies()	会话管理	Cookie: sessionId=abc123

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

如何解决Could not transfer artifact org.spri
在Maven更新过程中遇到“Could not transfer artifact org.springframework.boot”错误通常是由于网络问题,解决方法是在Maven的设置中忽略HTTPS,添加特定语句后,可以正常下载依赖,但下载速度可能较慢,这是一种常见的解决方案,希望对遇到相同问题的人有所帮助
2024-09-09
SpringBoot之Java配置的实现
这篇文章主要介绍了SpringBoot之Java配置的实现，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2019-01-01
Springboot logback-spring.xml无法加载问题
这篇文章主要介绍了Springboot logback-spring.xml无法加载问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2024-05-05
Spring Boot如何处理@Resource示例分析
这篇文章主要为大家介绍了Spring Boot如何处理@Resource示例分析，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2023-07-07
druid执行SQL出现错误但不影响返回结果的问题及解决
这篇文章主要介绍了druid执行SQL出现错误但不影响返回结果的问题及解决方案,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2023-12-12
Springboot如何集成jodconverter做文档转换
这篇文章主要介绍了Springboot如何集成jodconverter做文档转换问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2024-08-08
Spring Boot 快速入门指南
Spring 框架是非常著名的 Java 开源框架，历经十多年的发展，整个生态系统已经非常完善甚至是繁杂，Spring Boot 正是为了解决这个问题而开发的，为 Spring 平台和第三方库提供了开箱即用的设置，只需要很少的配置就可以开始一个 Spring 项目
2017-03-03
Spring Data JPA使用Sort进行排序（Using Sort）
本篇文章主要介绍了Spring Data JPA使用Sort进行排序（Using Sort），具有一定的参考价值，有兴趣的可以了解一下
2017-07-07
Java之Runnable启动线程的使用方式
这篇文章主要介绍了Java之Runnable启动线程的使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2024-01-01
Java常用加密算法实例总结
这篇文章主要介绍了Java常用加密算法,结合实例形式总结分析了base64、md5、sha、rsa、des等加密算法实现技巧,需要的朋友可以参考下
2017-10-10