Spring MVC 核心注解与参数传递实战指南

针对 Integer 类型

@RequestMapping("/r2") 
public String r2(Integer age){ 
    return "接收到参数，age:"+age; 
} 

对于包装类型 Integer，当不传参数时，默认值为 null。如果传参名字不一致，值也是默认值 null。这比基本类型更宽容一些。

针对 int 类型

@RequestMapping("/r3") 
public String r2(int age){ 
    return "接收到参数，age:"+age; 
} 

注意这里！对于 int 类型的参数，如果传参的参数名不一致时，会报错且错误码为 500；如果不传参，也会报错且错误码为 500。这一点与 int 的包装类型 Integer 不一样，基本类型不能为 null，所以必须传值且匹配。

针对自定义类型

@RequestMapping("/r5") 
public String r5(Student student){ 
    return "接收到参数，student:"+student; 
} 

针对自定义类型，如果不传参也不会报错，包装类型参数的默认值为 null，如果传参类型不匹配会报错。Spring 会自动尝试将请求参数映射到对象的字段上。

多参数与重命名

多个参数

@RequestMapping("/r4") 
public String r4(String name,Integer age){ 
    return "接收到参数，name:"+name+",age:"+age; 
} 

多个参数时，依然遵循参数名匹配原则。

参数重命名

有时候前端传来的参数名和后端不想用一样的，或者为了规范统一，可以使用 @RequestParam。

强制一致：

@RequestMapping("/r6") 
public String r6(@RequestParam("name") String userName){ 
    return "接收到参数，name:"+userName; 
} 

当参数重命名之后，默认要求该参数必须传参，否则会报错（错误码 400）。

不强制一致：

@RequestMapping("/r7") 
public String r7(@RequestParam(value = "name",required = false) String userName){ 
    return "接收到参数，name:"+userName; 
} 

添加 required = false 之后，该参数就不要求必须传递了，不传则默认为 null。

集合与 JSON 数据

传递数组

@RequestMapping("/r8") 
public String r8(String[] array){ 
    return "接收到参数，array:"+ Arrays.toString(array); 
} 

支持直接传递数组，前端可以重复提交同名参数或逗号分隔。

传递 List

@RequestMapping("/r9") 
public String r9(List<String> list){ 
    return "接收到参数，list:"+list; 
} 

当参数类型是 List 类型时，必须添加 @RequestParam 注解，否则可能会报错或无法正确解析。建议加上 required = false 以防万一。

传递 JSON

@RequestMapping("/r10") 
public String r10(@RequestBody Student student){ 
    return "接收到参数，student:"+student; 
} 

当传递 Json 字符串时，必须添加 @RequestBody 注解。这是因为 Spring MVC 默认会将请求体当作表单参数处理，而 @RequestBody 告诉容器将整个请求体反序列化为对象。

路径变量与文件上传

从路径中获取参数

有时候 ID 直接放在 URL 里，比如 /article/{id}。

获取单个参数：

@RequestMapping("/article/{articleId}") 
public String r11(@PathVariable("articleId") Integer articleId){ 
    return "接收到参数，article:"+articleId; 
} 

需要加 @PathVariable 注解。虽然 Spring MVC 也可以尝试通过参数名来自动匹配，但使用 @PathVariable 增加了代码的清晰度和明确性，特别是在 URL 模板中的变量名与方法参数名不一致时，它能提供额外的灵活性。

获取多个参数：

@RequestMapping("/article/{articleId}/{name}") 
public String r12(@PathVariable("articleId") Integer articleId,@PathVariable("name") Integer name){ 
    return "接收到参数，article:"+articleId+",name:"+name; 
} 

在通过路径获取参数时，如果从路径中获取多个参数，传参时必须每个都传递，否则会报错。

上传文件

@RequestMapping("/r13") 
public String r13(@RequestPart("file")MultipartFile file){ 
    String originalFilename=file.getOriginalFilename(); 
    return "接收到参数，文件名称:"+originalFilename; 
} 

在上传文件时，注意文件大小限制，过大的文件会导致上传失败。

以上就是 Spring MVC 中关于参数传递的核心知识点。实际开发中，根据场景选择合适的注解组合，能大大减少 Bug 的产生。