@pathvariable用于绑定url路径占位符参数，支持单个/多个变量、自动类型转换及异常处理，但不支持required=false，可选场景应改用@requestparam或双路径设计。
在 Spring Boot 的 REST 接口中，@PathVariable 是获取 URL 路径中占位符参数的标准方式。它直接绑定请求路径里的变量名到方法参数上，无需解析字符串或手动截取。
基础用法：匹配单个路径变量
URL 中用 {xxx} 定义占位符，方法参数用 @PathVariable("xxx") 绑定：
@GetMapping("/users/{id}")
public String getUserById(@PathVariable("id") Long id) {
return "User ID: " + id;
}
访问 /users/123 时，id 自动被解析为 Long 类型的 123。若参数名与占位符名一致（如都叫 id），可省略括号内容：
@GetMapping("/users/{id}")
public String getUserById(@PathVariable Long id) { // 省略名称，自动按参数名匹配
return "User ID: " + id;
}
多个路径变量：支持组合路径
URL 可包含多个占位符，对应多个 @PathVariable 参数：
@GetMapping("/users/{userId}/orders/{orderId}")
public String getOrderDetail(
@PathVariable Long userId,
@PathVariable Long orderId) {
return "User " + userId + " order " + orderId;
}
访问 /users/100/orders/200 即可分别提取两个值。注意顺序无关，Spring 按变量名匹配，不是按参数位置。
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
类型转换与异常处理
@PathVariable 支持自动类型转换（如 String、Long、Integer、UUID 等）。若传入非法值（如 /users/abc 请求 Long id），Spring 默认返回 400 Bad Request。
若需自定义错误响应，可用 @ExceptionHandler 捕获 TypeMismatchException 或全局处理 MethodArgumentTypeMismatchException。
可选路径变量（不推荐，慎用）
路径变量默认是必须的。若想设为可选，不能直接加 required = false（@PathVariable 不支持该属性）。替代方案是：
- 用两个不同路径映射（如
/users和/users/{id}） - 改用
@RequestParam配合查询参数（如/users?id=123） - 使用正则表达式限定路径（如
@GetMapping("/users/{id:\d+}")），让非法格式根本无法匹配到该接口
不建议强行“模拟可选路径变量”，会破坏 RESTful 设计原则，也增加路由歧义风险。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
