滥用@PathVariable导致bug原因分析解决

目录

• 前言
• 复现
• 3个匹配步骤
• 1，根据Path精准匹配
• 2，如果精准匹配没有成功，就开始模糊匹配
• 3，如果模糊匹配还匹配不上，就返回null
• 最后

前言

最近测试同学反馈，上周上线的一个功能会偶然性的报404，按理说这个功能在测试环境已经测试通过，也在线上运行了好几天，怎么会突然报错呢。

一开始以为是前端同学请求的接口有误，但是测试又说只是偶然性的404，几率也不高，于是打开日志找到对应的接口，一眼看到了接口上定义的@PathVariable，再一看参数，基本就确定是开发同学为了偷懒又误用@PathVariable导致的了。

先说结论吧：@PathVariable可以使请求参数动态的绑定到URL上，但是如果请求参数中包含特殊字符，比如 /,就可能导致Spring匹配到一个错误的URL，或者匹配不到合适的URL。

复现

下面，我用一个简单的伪代码复现一下这个bug，与大家分析一下这个bug发生的原因，以及如何解决，最后顺便再通过源码加深一下印象。

如下，我们定义一个接口，并且通过@PathVariable将入参动态的绑定到URL上。

@RestController
@RequestMapping(value = "/demo")
public class DemoController {
    @GetMapping(value = "/getVal/{val}")
    public ResponseEntity