解决HTTP路径正则映射下控制器处理方法歧义失效问题

嘿，我来帮你搞定这个路径映射的歧义问题！

首先先把你提供的代码片段格式化清楚，方便分析：

@GetMapping(value = "/trucks/{truckId:[0-9]+}")
@ResponseStatus(HttpStatus.FOUND)
@ResponseBody
public final TruckDto getTruckId(@PathVariable(value = "truckId") final String truckId) {
    LOGGER.debug("test: truckId({})", truckId); // 补全你漏写的日志参数哦
    Truck truck = truckService.getTruckById(Integer.parseInt(truckId));
    // 转换为TruckDto的后续逻辑...
}

// 我猜你的按名称获取方法大概是这样的？
@GetMapping(value = "/trucks/{truckName}")
@ResponseStatus(HttpStatus.FOUND)
@ResponseBody
public final TruckDto getTruckByName(@PathVariable(value = "truckName") final String truckName) {
    Truck truck = truckService.getTruckByName(truckName);
    // 转换为TruckDto的后续逻辑...
}

正则没生效、路径匹配混乱，大概率是这几个原因导致的，给你逐一排查解决：

1. 方法定义顺序搞反了 #

Spring MVC匹配路径是按方法定义的先后顺序尝试匹配的！如果你的getTruckByName方法写在getTruckId前面，那哪怕是数字路径（比如/trucks/123）也会先被{truckName}这个通用匹配规则接住，正则规则根本没机会生效。

解决办法：把带正则（或者更具体匹配规则）的getTruckId方法，放在getTruckByName方法前面，让Spring优先匹配更精准的路径。

2. 换个更简洁的区分方式：用参数类型替代正则 #

其实你完全不用写正则，直接把truckId的参数类型改成Integer，Spring会自动帮你做类型校验和匹配：

// 按ID获取（只匹配数字路径）
@GetMapping(value = "/trucks/{truckId}")
@ResponseStatus(HttpStatus.FOUND)
@ResponseBody
public final TruckDto getTruckId(@PathVariable(value = "truckId") final Integer truckId) {
    LOGGER.debug("test: truckId({})", truckId);
    Truck truck = truckService.getTruckById(truckId);
    // 后续逻辑...
}

// 按名称获取（匹配非数字的字符串路径）
@GetMapping(value = "/trucks/{truckName}")
@ResponseBody
public final TruckDto getTruckByName(@PathVariable(value = "truckName") final String truckName) {
    Truck truck = truckService.getTruckByName(truckName);
    // 后续逻辑...
}

这种方式下，请求/trucks/123会自动匹配到参数为Integer的方法；请求/trucks/my-freight-truck则会匹配到String参数的方法，完全避免歧义，还比正则更直观。

3. 检查是否有其他路径冲突 #

如果上面两种方法都没用，那得看看有没有其他控制器定义了/trucks/**这类通配路径，或者全局配置了路径前缀，导致实际匹配的路径和你预期的不一致。

最后测试的时候，记得分别请求数字路径和字符串路径，观察日志输出，确认是否匹配到了对应的方法就行。

内容的提问来源于stack exchange，提问作者valik