Spring MVC 四种核心传参形式对比分析

在使用 Spring MVC 编写接口时，我们几乎每天都在和“参数”打交道。
路径参数、请求参数、JSON、对象接收……看起来方式很多，但如果只停留在“记注解”，很容易越学越乱。

事实上，从参数来源的角度来看，Spring MVC 中绝大多数的传参方式都可以归纳为 四种核心形式：路径参数、请求参数、请求体参数、对象参数

理解这四类参数的来源和适用场景，基本就掌握了 Spring MVC 80% 的参数接收机制。

一、路径参数：参数直接来自 URL 路径

1. 什么是路径参数

路径参数是 URL 路径本身的一部分，通常用于表示某个具体资源。

GET /users/1

其中的 1，就是一个典型的路径参数。

2. 使用方式

@GetMapping("/users/{id}")
public User getUser(@PathVariable Long id) {
    return userService.getById(id);
}

3. 特点与适用场景

• 参数嵌入在 URL 中，语义清晰
• 符合 RESTful 设计风格
• 通常用于资源的定位

常见场景：

• 根据 id 查询详情
• 根据 id 删除资源

二、请求参数：来自 URL 或表单的 key-value 参数

1. 什么是请求参数

请求参数通常以 key=value 的形式出现，存在于 URL 查询串或表单数据中。

GET /users?name=zhangsan&age=18

2. 使用方式

@GetMapping("/users")
public List<User> list(
        @RequestParam String name,
        @RequestParam Integer age) {
    return userService.list(name, age);
}

3. 特点与适用场景

• 参数形式简单、直观
• 适合可选参数较多的场景
• 不具备强结构性

常见场景：

• 条件查询
• 分页、排序参数

三、请求体参数：来自 HTTP Request Body 的结构化数据

1. 什么是请求体参数

请求体参数来源于 HTTP 请求体，通常是 JSON 格式，前后端分离项目中非常常见。

{
  "name": "zhangsan",
  "age": 18
}

2. 使用方式

@PostMapping("/users")
public void save(@RequestBody User user) {
    userService.save(user);
}

3. 特点与适用场景

• 数据结构清晰、层次分明
• 通常用于 POST、PUT 请求
• 依赖 HttpMessageConverter 进行解析

常见场景：

• 新增数据
• 更新数据
• 前后端分离接口

四、对象参数：请求参数的自动封装

1. 什么是对象参数

对象参数并不是单独的一种数据来源，而是 Spring MVC 将请求参数自动绑定为 Java 对象的结果。

POST /users
name=zhangsan&age=18

2. 使用方式

@PostMapping("/users")
public void save(User user) {
    userService.save(user);
}

3. 底层原理说明

Spring 会根据以下规则进行自动绑定：

• 请求参数名
• 对象属性名
• 对应的 setter 方法

只要三者匹配，就可以完成自动封装。

这是 Spring MVC 非常“无感但强大”的能力。

五、一个非常容易混淆的点

对象参数 ≠ 请求体参数

很多人容易把下面两种写法混为一谈：

public void save(User user)              // 对象参数（来自请求参数）
public void save(@RequestBody User user) // 请求体参数（来自 JSON）

关键区别在于：

• 是否使用 @RequestBody
• 参数来自请求参数，还是请求体

这一点在实际开发中非常重要。

六、四种传参形式对比总结

七、总结

Spring MVC 的传参，本质是根据“参数来源不同”，选择不同的解析与绑定方式。

到此这篇关于Spring MVC 四种核心传参形式对比分析的文章就介绍到这了,更多相关Spring MVC传参内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！