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内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

详解非spring框架下使用querydsl的方法
Querydsl是一个采用API代替拼凑字符串来构造查询语句，可跟 Hibernate 和 JPA 等框架结合使用。本文介绍的是非spring环境下querydsl JPA整合使用，感兴趣的小伙伴们可以参考一下
2019-01-01
Java并发编程示例(二)：获取和设置线程信息
这篇文章主要介绍了Java并发编程示例(二)：获取和设置线程信息,本文是系列文章的第二篇,本文着重讲解Thread类的几个重要属性,需要的朋友可以参考下
2014-12-12
JDBC获取数据库连接由浅入深
大家好，本篇文章主要讲的是JDBC获取数据库连接由浅入深，感兴趣的同学赶快来看一看吧，对你有帮助的话记得收藏一下
2022-02-02
java学习之路_篇超好的文章
一篇超好的文章！就看你有没耐心看！java学习之路！
2008-10-10
Spring Boot 整合持久层之MyBatis
在实际开发中不仅仅是要展示数据，还要构成数据模型添加数据，这篇文章主要介绍了SpringBoot集成Mybatis操作数据库，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2022-08-08
Java CompletableFuture实现原理分析详解
CompletableFuture是Java8并发新特性，本文我们主要来聊一聊CompletableFuture的回调功能以及异步工作原理是如何实现的，需要的可以了解一下
2022-09-09
带你快速搞定java多线程(5)
这篇文章主要介绍了java多线程编程实例，分享了几则多线程的实例代码，具有一定参考价值，加深多线程编程的理解还是很有帮助的，需要的朋友可以参考下
2021-07-07
jdbc结合dpcp连接池的封装实例
下面小编就为大家带来一篇jdbc结合dpcp连接池的封装实例。小编觉得挺不错的，现在就分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2017-10-10
mybatis查询oracle long类型的踩坑记录
这篇文章主要介绍了mybatis查询oracle long类型的踩坑记录，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2023-03-03
springboot websocket简单入门示例
这篇文章主要介绍了springboot websocket简单入门示例，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2018-08-08