Spring MVC参数绑定终极手册：单&多参/对象/集合/JSON/文件上传精讲

Mr Aokey2025-06-06 23:04

我们通过浏览器访问不同的路径，就是在发送不同的请求，在发送请求时，可能会带一些参数，本文将介绍了Spring MVC中处理不同请求参数的多种方式

一、传递单个参数

接收单个参数，在Spring MVC中直接用方法中的参数就可以，如以下代码：

java 复制代码 
@RequestMapping("Param")
@RestController
public class ParamController {
    @RequestMapping("a1")
    public String tex1(String string){
        return "接收到参数："+string;
    }
}

我们使用Postman 传参后，浏览器访问 127.0.0.1:8080/Param/a1?string=Spring

Spring MVC会根据方法，找到对应的参数，赋值给方法，参数不一致，是获取不到参数，即为null（包装类型）

注意：

使用基本类型来接收参数时，参数必须传（除boolean类型），否则报500错误；类型不匹配，会报400错误(此处400/500等都是状态码，其他篇章会涉及讲解)

1.1、正常传递参数

java 复制代码 
@RequestMapping("a2")
    public Object text2(int a){
        return "接收到参数a："+a;
    }

通过Fiddler观察请求和响应, HTTP响应状态码为200（正常）

1.2、不传a参数

通过Fiddler观察请求和响应, HTTP响应状态码为500（服务器异常）

尝试观察程序的错误日志，并解决：

可选的整型参数"a"存在，但由于被声明为基本类型，所以无法转换为 null 值。建议将其声明为对应基本类型的对象包装器。

1.3、传递参数类型不匹配

对于包装类型, 如果不传对应参数，Spring 接收到的数据则为null。所以开发中，对于参数可能为空的数据，建议使用包装类型

二、传递多个参数

和传输一个参数一样，直接使用方法的参数接收即可

java 复制代码 
@RestController
public class ParamController {
    @RequestMapping("Param")
    public String Demo1(String name,String age){
            return "接收到参数name: "+name+" ,age: "+age;
    }
}

使用浏览器发送请求并传参：127.0.0.1:8080/Param?name=小奥奇&age=8

可以发现，后端程序是正确拿到 name 和 age参数的值

当有多个参数时，前后端是以参数的名称进行参数匹配的，但是参数的位置是不影响后端获取参数的结果

三、传递对象

如果需要传递的参数较多时，使用方法传参就要有很多形参，并且后续每增加一个参数，也要修改方法的声明，比较麻烦~，在此情况下我们便可以把这些参数封装成一个对象

Spring MVC 也可以自动实现对象参数的赋值，我们先创建一个 Cat对象

java 复制代码 
public class Cat {
    private String name;
    private int age;
    private String hobby;
    public String getName() {
        return name;
    }
    public int getAge() {
        return age;
    }
    public String getHobby() {
        return hobby;
    }
    public void setName(String name) {
        this.name = name;
    }
    public void setAge(int age) {
        this.age = age;
    }
    public void setHobby(String hobby) {
        this.hobby = hobby;
    }
    @Override
    public String toString() {
        return "Cat{" +
                "name='" + name + '\'' +
                ", age=" + age +
                ", hobby='" + hobby + '\'' +
                '}';
    }
}

实现传递对象的方法

java 复制代码 
  @RequestMapping("Cat")
    public Object Cat(Cat cat){
        return cat.toString();
    }

使用浏览器发送请求并传参：127.0.0.1:8080/Cat?name=咪咪&age=1&hobby=喜欢吃小鱼干

正好对应我们 Cat 类中的三个成员变量，此过程中 Spring 会根据参数名称自动绑定到对象的各个属性 上，如果属性未传递，则会赋值位null（基本类型会被赋值为默认初始值，比如 int 赋值 0）

四、后端参数重命名（后端参数映射）

在一些情况下，前端传递的参数 key 和我们后端接受的 key 可以不一致，比如前端想加密URL 中的信息，会使用 p 传递给后端，后端是使用 password 字段来接收的（保证可读性，不然后续维护时，不知道 p 到底是什么），如果出现这种情况，我们可以使用 @RequestParam 来重命名前后端的参数值

java 复制代码 
 @RequestMapping("A1")
    public String A1(@RequestParam("p") String password){
        return "接收参数: password:"+password;
    }

该注解表示从前端接收到 p 赋值给 password

那如果我们直接传递给后端的参数 password呢？

2025-05-30T22:37:36.378+08:00 WARN 27268 --- [SpringDemo1] [nio-8080-exec-2] .w.s.m.s.DefaultHandlerExceptionResolver : Resolved [org.springframework.web.bind.MissingServletRequestParameterException: Required request parameter 'p' for method parameter type String is not present]

控制台打印日志显示：请求参数 p 不存在

那既然是 String 引用类型，我们尝试不传参数试试，会不会得到 null ~~

我们发现，当不传参数时，直接报客户端错误了，因为当我们使用该注解时，这个参数就变成必传参数了，我们点进该注解的源码中：

表示：若请求缺失此参数，会抛出MissingServletRequestParameterException ，返回 HTTP 400（Bad Request） 错误，我们可以通过设置该 required 使该参数为非必传参数

java 复制代码 
@RequestMapping("A1")
    public String A1(@RequestParam(value = "p",required = false) String password){
        return "接收参数: password:"+password;
    }

将 required 设置为 false，再次空传参数得到：

结论：

使用 @RequestParam 进行参数重命名时，请求参数只能和 @RequestParam 声明的名称一致，才能进行参数绑定和赋值

使用 @RequestParam 进行参数重命名时， 参数就变成了必传参数

五、传递数组

java 复制代码 
@RequestMapping("A2")
    public String A2(String[] arr){
        return "接收参数：arr:"+ Arrays.toString(arr);
    }

和传递引用类型一样，直接把数组当成参数，那数组包含多个元素，我们该如何传递呢？

此外，我们还可以直接使用方式二在一行中传递多个元素：

可以看到，方式二每个元素是以逗号分隔的，但是如果我们本来就要传递一个逗号呢？

那么逗号就会转义为%2c

六、传递集合

集合参数 ：和数组类似，同一个请求中出现多个同名参数，需要使用@RequestParam绑定参数关系，Spring自动将其值收集到一个集合中

java 复制代码 
@RequestMapping("A1")
    public String A1(@RequestParam List<Integer> list){
        return "接收参数："+list;
    }

七、传递JSON数据

7.1、概念

JSON概念：JSON 全称为 ​​JavaScript Object Notation​ ​（JavaScript 对象表示法），是一种​​轻量级的数据交互格式​​。

简单来说：JSON就是客户端和服务端进行交互的一种数据格式 ，有自己的格式和语法 ，使用文本表示对一个对象或数组的信息 ，因此本质上是字符串 ，主要负责在不同的语言中数据传递和交换

7.2、JSON语法

还可以压缩为：

{"name":"Json.CN","url":"http://www.json.cn","page":88,"isNonProfit":true,"address":{"street":"科技园路.","city":"江苏苏州","country":"中国"},"links":[{"name":"Google","url":"http://www.google.com"},{"name":"Baidu","url":"http://www.baidu.com"},{"name":"SoSo","url":"http://www.SoSo.com"}]}

我们可以使用在线JSON格式化工具 来进行校验和书写：https://www.bejson.com/

7.3、JSON的优点：

  1. ​简单易用​：语法简单，易于理解和编写，可以快速进行数据交换。
  2. ​跨平台支持​：JSON可以被多种编程语言解析和生成，可以在不同的平台和语言之间进行数据交换和传输。
  3. ​轻量级​：相较于XML格式，JSON数据格式更加轻量级，传输数据时占用带宽较小，可以提高数据传输速度。
  4. ​易于扩展​：JSON的数据结构灵活，支持嵌套对象和数组等复杂的数据结构，便于扩展和使用。
  5. ​安全性​：JSON数据格式是一种纯文本格式，不包含可执行代码，不会执行恶意代码，因此具有较高的安全性。

7.4、JSON字符串和Java对象互转

Spring MVC框架集成了JSON的转换工具，我们可以直接使用来完成两者的互转

本质上是 jackson-databind 提供的功能，SpringMVC 框架中已经把该工具包引入了进来，咱们直接使用即可,如果脱离SpringMVC 使用，需要引入相关依赖

使用 ObjectMapper 对象提供的两个方法，可以完成对象和JSON 字符串的互转 writeValueAsString : 把对象转为JSON 字符串 readValue: 把字符串转为对象

java 复制代码 
public class JSONText {
    @Test
    public void JsontoJava() throws JsonProcessingException {
        ObjectMapper mapper = new ObjectMapper();
        //定义一个JSON字符串
        String s="{\"name\":\"咪咪\",\"age\":1,\"color\":\"blue\"}";
        //转对象
        Animals cat=mapper.readValue(s,Animals.class);
        System.out.println(cat.toString());
    }
    @Test
    public void JavatoJson() throws JsonProcessingException {
        ObjectMapper mapper = new ObjectMapper();
        //创建Java对象
        Animals cat = new Animals();
        cat.setName("cat");
        cat.setAge(1);
        cat.setColor("blue");
        //转换为JSON
        String str = mapper.writeValueAsString(cat);
        System.out.println(str);
    }
}

7.5、传递JSON对象

接收JSON对象，需要使用@RequestBody注解

RequestBody​ ​：请求正文，意思是这个注解作用在请求正文的数据绑定，​​请求参数必须写在请求正文中​​。

java 复制代码 
@RequestMapping("A3")
    public String A3(@RequestBody Animals animals){
        return animals.toString();
    }

我们再postman 中传入的是JSON格式的字符串，但在后端代码中，Spring会把我们传入的JSON字符串转化成一个对象，我们就不用自己转化为Java对象了，还可以对此对象进行操作：

java 复制代码 
@RequestMapping("A3")
    public String A3(@RequestBody Animals animals){
        System.out.println(animals.getColor());
        animals.color="彩虹色";
        return animals.toString();
    }

八、获取URL中参数@PathVariable

这个注解主要作用在请求URL路径上的数据绑定（默认传递参数写在URL上，Spring MVC 就可以获取到）

java 复制代码 
@RequestMapping("A4/{id}")
    public String A4(@PathVariable Integer id){
        return "获取id: "+id;
    }

我们还可以传递两个参数：

java 复制代码 
@RequestMapping("A4/{id}/{age}")
    public String A4(@PathVariable Integer id,@PathVariable Integer age) {
        return "获取id: "+id+",age: "+age;
    }

这两个也默认为必传参数，如果我们只传递一个参数，会发生客户端错误，那么我们是否可以设置为非必传参数

答案是：理论上可以，但是我们若对改路径传一个参数，那么这个参数是id 还是age ???Spring也不知道，所以参数是必传的，另外我们可以重命名（此处不再演示）

九、上传文件@RequestPart

java 复制代码 
 @RequestMapping("A5")
    public String A5(MultipartFile file) {
        System.out.println(file.getOriginalFilename());
        return "文件获取成功";
    }
相关推荐
汪子熙几秒前
Cursor 中代码库索引（codebase indexing）功能背后的核心技术实现原理
人工智能·后端
weixin_4365250714 分钟前
Spring Boot 实现流式响应（兼容 2.7.x）
java·spring boot·后端
源码超级联盟20 分钟前
分享一个空指针的bug
java·后端
weixin_4293260927 分钟前
Spring Boot-面试题(52)
java·spring boot·后端
暴躁哥28 分钟前
Spring Boot 类加载机制深度解析
spring boot·后端·类加载机制
qq_3380329229 分钟前
Spring Boot/Spring应用中配置自定义RedisTemplate
spring boot·redis·spring
掘金狂热勇士1 小时前
PGM格式：一种简单而实用的灰度图像存储方案
后端
毅航1 小时前
Trae复刻Mybatis之旅（一）：创建SqlSession会话，构建代理
后端·mybatis·trae
代码丰1 小时前
令牌桶 滑动窗口-＞限流 分布式信号量-＞限并发的原理 lua脚本分析介绍
java·分布式·lua
考虑考虑1 小时前
Springboot3.5.x版本actuator新属性
spring boot·后端·spring
热门推荐
01基于STM32的智能电池管理系统02KGG转MP3工具|非KGM文件|解密音频03YOLOv8入门 | 重要性能衡量指标、训练结果评价及分析及影响mAP的因素【发论文关注的指标】04海康Visionmaster-常见问题排查方法-启动阶段05从零安装 LLaMA-Factory 微调 Qwen 大模型成功及所有的坑06【SpeedAI科研小助手】2分钟极速解决知网维普重复率、AIGC率过高，一键全文降！文件格式不变，公式都保留的！07【无人机】无人机通信模块，无人机图数传模块的介绍，数传，图传，图传数传一体电台，08DeepSeek各版本说明与优缺点分析09组基轨迹建模 GBTM的介绍与实现（Stata 或 R）10VMware虚拟机安装Win7专业版保姆级教程（附镜像包）