springboot中@RequestParam和@PathVariable区别

更新时间：2025年07月21日 09:01:42 作者：ruan114514

本文主要介绍了springboot中@RequestParam和@PathVariable区别,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

1. 参数位置不同

注解	参数位置	示例 URL
@RequestParam	URL 查询字符串 (?之后)	/users?name=John&age=25
@PathVariable	URL 路径部分 ({}占位符)	/users/{id}/orders/{orderId}

2. 核心用途不同

注解	主要用途	典型场景
@RequestParam	获取可选或必选的查询参数	过滤、排序、分页等查询条件
@PathVariable	获取RESTful 资源标识符	资源ID、唯一标识等路径变量

3. 功能特性对比

特性	@RequestParam	@PathVariable
是否必需	可通过 required=false 设为可选	默认必需（路径必须包含）
默认值	支持 defaultValue	不支持默认值
多值支持	支持数组/集合 (如 List<String>)	不支持多值（单个路径变量）
参数名称灵活性	可通过 value 指定参数名	必须与路径占位符名称匹配
RESTful 设计	非 RESTful 核心元素	RESTful 资源定位的关键组成部分

4. 代码示例对比

@RequestParam 示例：

// 获取查询参数：/search?keyword=spring&page=2
@GetMapping("/search")
public Result search(
    @RequestParam String keyword, 
    @RequestParam(defaultValue = "1") int page) {
    // ...
}

@PathVariable 示例：

// 获取路径变量：/users/123/orders/456
@GetMapping("/users/{userId}/orders/{orderId}")
public Order getOrder(
    @PathVariable Long userId,
    @PathVariable String orderId) {
    // ...
}

原则	@RequestParam	@PathVariable
RESTful 规范	用于非资源属性	用于资源标识符
幂等性	不影响资源标识	直接标识资源
缓存友好度	查询参数不影响缓存键	路径变量是缓存键的一部分
SEO 友好度	对SEO不友好（动态参数）	对SEO更友好（静态路径）

到此这篇关于springboot中@RequestParam和@PathVariable区别的文章就介绍到这了,更多相关springboot @RequestParam @PathVariable内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

如何自定义feign调用实现hystrix超时、异常熔断
这篇文章主要介绍了自定义feign调用实现hystrix超时、异常熔断的操作，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2021-06-06
java如何使用fastjson修改多层嵌套的Objectjson数据
这篇文章主要介绍了java如何使用fastjson修改多层嵌套的Objectjson数据问题，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2023-05-05
基于Jenkins+Maven+Gitea+Nexus搭建CICD环境的方式
这篇文章主要介绍了基于Jenkins+Maven+Gitea+Nexus从0到1搭建CICD环境,大家都知道Nexus是一套“开箱即用”的系统不需要数据库，它使用文件系统加Lucene来组织数据，需要的朋友可以参考下
2022-01-01
浅谈java对象的比较
这篇文章主要给大家分享java对象的比较，主要有元素的比较、类的比较及比较的方法，想具体了解的小伙伴和小编一起进入下面文章内容吧
2021-10-10
详解spring自动扫描包
这篇文章主要介绍了spring自动扫描包的相关知识，本文通过实例相结合的形式给大家介绍的非常详细，感兴趣的朋友跟随脚本之家小编一起看看吧
2018-06-06
java实现雪花算法ID生成器工具类
本文主要介绍了java实现雪花算法ID生成器工具类，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2023-07-07
如何解决getReader() has already been called&
这篇文章主要介绍了如何解决getReader() has already been called for this request问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2024-05-05
feign实现传递参数的三种方式小结
这篇文章主要介绍了feign实现传递参数的三种方式小结，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2021-06-06
Mybatis初始化知识小结
Mybatis的初始化过程就是加载自己运行时所需要的配置信息的过程，这篇文章主要介绍了Mybatis初始化知识小结,需要的朋友可以参考下
2021-10-10
Java使用正则表达式检索、替换String中特定字符和正则表达式的一切
这篇文章主要给大家介绍了关于Java使用正则表达式检索、替换String中特定字符和正则表达式的一切，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-09-09