@PathVariable不生效的常见原因是未加注解或路径模板与请求不匹配，需显式标注且占位符须一一对应，不可与@RequestParam混用，同时注意HTTP动词严格匹配、CORS配置、JSON接收用@RequestBody、路径顺序及正则约束。
Spring Boot里@PathVariable不生效，URL路径写对了但参数始终为null
常见原因是没在方法参数上加@PathVariable注解，或者路径模板和实际请求不匹配。比如控制器写了@GetMapping("/user/{id}")，但方法签名是getUser(String id)——漏掉注解，Spring不会自动绑定。
- 必须显式标注
@PathVariable("id") String id，如果变量名和路径占位符一致（都是id），可简写为@PathVariable String id - 路径中多个占位符要一一对应，
/order/{orderId}/item/{itemId}就得用两个@PathVariable参数，不能靠顺序推断 - 别把
@PathVariable和@RequestParam混用：前者从URL路径截取，后者从查询字符串（?key=value）解析，类型错误会导致404或400
GET/POST/PUT/DELETE动词映射时，IDEA提示“Method not allowed”或405错误
不是HTTP动词写错了，而是Spring默认只允许特定动词访问某些端点。比如@PostMapping方法被浏览器地址栏直接GET访问，必然报405；后端没开CORS或前端发了预检请求（OPTIONS），也可能触发拦截。
- 确认请求方式与注解严格一致：
@GetMapping只响应GET，@PostMapping只响应POST，大小写敏感 - 测试时用
curl或Postman，避免浏览器缓存或自动转GET的干扰，例如：curl -X POST http://localhost:8080/api/user - 如果前端发的是JSON数据，后端方法必须有
@RequestBody接收，且Controller类上要有@RestController，否则Spring MVC可能走视图解析流程
RESTful路径设计中，/users和/users/{id}冲突导致404
不是路由优先级问题，而是Spring按声明顺序匹配，但更常因路径模板太宽泛导致覆盖。比如@GetMapping("/users/{id}")写在@GetMapping("/users")前面，而{id}又恰好能匹配字符串"all"或"count"，就会误入ID分支。
- 把通用路径（如
/users）放在具体路径（如/users/{id}）之前，Spring会优先匹配更短、更明确的模式 - 给
{id}加正则约束，避免匹配非数字值：@GetMapping("/users/{id:\d+}")，这样/users/all就不会进这个方法 - 路径层级别嵌套过深，比如
/org/{orgId}/dept/{deptId}/user/{userId}，调试时容易看漏某一层，建议用日志输出request.getRequestURL()确认真实请求路径
返回JSON时中文乱码、空字段不忽略、时间格式不符合ISO 8601
Spring Boot 2.3+默认用Jackson序列化，但没配好全局配置的话，中文会变问号，null字段照常输出，LocalDateTime直接抛异常。
立即学习“Java免费学习笔记（深入）”；
- 在
application.properties里加：spring.jackson.charset=UTF-8、spring.jackson.default-property-inclusion=NON_NULL - 时间字段统一用
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")标注，避免依赖全局设置失效 - 别在DTO里用
java.util.Date，优先选LocalDateTime并确保Jackson版本≥2.9，否则反序列化会失败
路径变量和HTTP动词看着简单，但每个斜杠、每个注解位置、每个字符类型都卡在Spring MVC的匹配规则里。最容易被忽略的是：路径模板里的{id}本质是个正则片段，默认等价于{id:.*}，它比你想象中更贪心。
