Spring REST API：如何解决AntPattern匹配器的歧义问题

问题描述 #

我有一个请求映射路径，其包含的模式可能位于路径中间或末尾，且包含特殊字符（最可能是/和-），形式如@RequestMapping("path1/{pattern}")或@RequestMapping("path1/{pattern}/remainingPath")。

• 场景1：请求路径为/order/orderId12/5，需要提取orderId12/5；
• 场景2：请求路径为/order/orderId12/5/details/update/dispatched，仅需提取orderId12/5。

已尝试的方法：

1. 使用PathPattern：

   @RequestMapping("/order/**")
   @RequestMapping("/order/{*orderId}/details/update/{status}")
   

   但根据Spring文档，该方式无效，因为PathPattern中**仅支持在模式末尾使用；
2. 使用AntPatternMatcher：

   @RequestMapping("/order/**")
   @RequestMapping("/order/**/details/update/{status}")
   

   此时存在歧义，第二个请求会匹配到第一个请求映射。

解决方案 #

方案1：调整映射顺序+精确路径变量语法 #

Spring的请求映射匹配是自上而下执行的，把更具体的映射放在前面，泛化映射放在后面，同时使用{*变量名}语法捕获包含/的路径片段：

// 先定义匹配场景2的精确映射
@RequestMapping("/order/{*orderId}/details/update/{status}")
public String handleOrderDetails(@PathVariable String orderId, @PathVariable String status) {
    // 此处orderId即为orderId12/5
    return "order-details";
}

// 再定义匹配场景1的泛化映射
@RequestMapping("/order/{*orderId}")
public String handleOrder(@PathVariable String orderId) {
    // 此处orderId即为orderId12/5
    return "order";
}

{*orderId}语法支持捕获路径中包含/的片段，同时因为精确映射优先级更高，场景2的请求会先匹配到对应的处理方法，不会被泛化映射拦截。

方案2：自定义匹配优先级（进阶） #

如果默认匹配逻辑无法满足需求，可以自定义PathMatcher或PathPatternParser，重写匹配优先级规则，强制让包含后续固定路径段的映射拥有更高优先级。不过一般方案1已能解决大部分场景。

方案3：改用请求参数传递特殊ID #

如果前端可以配合修改请求方式，把包含/的ID放到请求参数中，比如/order/details/update/dispatched?orderId=orderId12/5，这种方式完全规避路径匹配歧义，实现起来更简单。

内容的提问来源于stack exchange，提问作者code-geek