@PathVariable用于从URL路径提取变量值，支持单个/多个变量绑定、自动类型转换、正则匹配（如{filename:.+}）及校验，但不支持required=false。
在 Spring MVC 中，@PathVariable 用于从 URL 路径中提取变量值，是 RESTful 风格接口开发的常用方式。它直接绑定 URI 模板中的占位符到方法参数，无需解析请求体或查询参数。
基本用法：匹配路径中的单个变量
URL 中用 {xxx} 定义占位符，方法参数加 @PathVariable("xxx") 注解即可获取对应值：
@GetMapping("/users/{id}")
public String getUser(@PathVariable("id") Long userId) {
// userId 就是 URL 中 /users/123 的 123
return "user-detail";
}
如果参数名与占位符名一致（如都叫 id），可省略注解中的名称：
@GetMapping("/users/{id}")
public String getUser(@PathVariable Long id) { // 自动按名字匹配
return "user-detail";
}
多个路径变量：支持同时提取多个值
一个 URL 可含多个占位符，对应多个 @PathVariable 参数：
立即学习“Java免费学习笔记（深入）”；
@GetMapping("/users/{userId}/orders/{orderId}")
public String getOrderDetail(
@PathVariable Long userId,
@PathVariable Long orderId) {
// 自动按参数名绑定 /users/5/orders/101 中的值
return "order-detail";
}
也可显式指定名称，避免依赖参数名（尤其在编译时未保留参数名的情况下）：
- 启用
-parameters编译选项，或使用 Lombok 的@AllArgsConstructor(onConstructor_ = @__{@Autowired})等方式保留参数名 - 更稳妥的做法是始终写明
@PathVariable("xxx")
类型转换与合法性校验
Spring 会自动将路径变量字符串转为目标类型（如 Long、Integer、String）。若转换失败（如传入非数字），默认返回 400 Bad Request。
可在参数上叠加校验注解（需配合 @Valid 或开启方法级验证）：
@GetMapping("/users/{id}")
public String getUser(@PathVariable @Min(1) Long id) {
return "user-detail";
}
注意：路径变量本身不支持 @RequestParam 那样的 required = false，因为它是 URL 模板的一部分 —— 如果该段路径不存在，请求根本不会匹配到这个 handler。
特殊字符与编码处理
路径变量中若含斜杠 /、点 . 等特殊字符，需确保前端正确编码（如用 encodeURIComponent），后端 Spring 会自动解码。
例如：/files/{filename:.+} 可匹配带扩展名甚至子路径的文件名：
@GetMapping("/files/{filename:.+}")
public String getFile(@PathVariable String filename) {
// 匹配 /files/report.pdf 或 /files/logs/2024/04/app.log
return "file-content";
}
这里的 :.+ 是正则表达式后缀，表示“匹配一个或多个任意字符”，用于放宽默认只匹配除 / 外字符的限制。
