@pathvariable 用于提取路径变量（如 /users/{id}），@requestparam 用于获取查询参数（如 ?page=2），二者应按语义区分使用：路径定资源、查询控行为，混合使用需避免同名歧义，且必须显式注解以保证可维护性。
@PathVariable 和 @RequestParam 是 Spring MVC 中处理前端参数最常用也最清晰的两种方式——一个专管“路径里是谁”，一个专管“URL 里问什么”。用对了，代码干净、语义明确、错误拦截早；用混了，容易漏校验、类型转换失败、404 或 400 报错莫名其妙。
路径变量：用 @PathVariable 提取资源标识
适合表达“哪个资源”，比如 /users/123、/orders/2024/1001。Spring 会把花括号 {} 里的内容自动绑定到方法参数，支持类型转换和命名控制：
- 参数名与路径变量名一致时，可省略 value：
@GetMapping("/users/{id}") public String detail(@PathVariable Long id) - 名字不同时必须显式指定：
@PathVariable("userId") Long id - 加正则约束能提前拦截非法输入，比如只接受数字 ID：
@GetMapping("/users/{id:\d+}")，访问 /users/abc 直接 404，不进控制器 - 多个变量按名匹配，顺序无关：
@GetMapping("/posts/{year}/{month}")→@PathVariable int year, @PathVariable String month
查询参数：用 @RequestParam 处理筛选与修饰
适合表达“要怎么查”，比如 ?page=2&size=10、?format=json、?active=true。它从 URL 查询字符串或 POST 表单中提取，更灵活但需注意必填逻辑：
- 默认 required = true，没传就报 400；设为 false 才可选：
@RequestParam(required = false) String keyword - 提供默认值更安全：
@RequestParam(defaultValue = "10") int size - 支持集合接收：
@RequestParam List<string> tags</string>，前端可传 ?tags=a&tags=b 或 ?tags=a,b - 类型自动转换（String → Integer、Boolean 等），失败抛 TypeMismatchException，返回 400
两者混合使用：RESTful 接口的标准写法
真实接口常是“路径定资源 + 查询控行为”，比如 /api/posts/123/comments?page=1&sort=createdAt：
- 路径变量识别具体资源：
@PathVariable Long postId - 查询参数控制分页、排序、过滤：
@RequestParam(defaultValue = "1") int page, @RequestParam String sort - 不建议把业务筛选条件塞进路径（如 /users/active），那属于查询语义，应走 @RequestParam
- 避免同时用同名参数：/users/{id}?id=999 会造成歧义，Spring 默认优先取路径变量
小技巧：不加注解也能工作，但不推荐
Spring 允许不加注解直接写形参（如 public String list(Long id)），框架会尝试按名称匹配查询参数或路径变量。但这会让意图模糊、调试困难、IDE 提示弱，还可能因参数名变更引发隐性 bug。明确使用 @PathVariable 和 @RequestParam 是更可控、更易维护的选择。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
