Spring Boot中如何区分两个路径参数路由？

问题根源 #

Spring MVC的路由匹配是按注册顺序优先匹配，而/{id}和/{username}都属于单路径变量的模糊匹配，框架无法通过变量名区分请求参数的类型或内容，所以第二个路由永远不会被触发。

可行解决方案 #

1. 给路由添加固定前缀区分 #

最直接可靠的方式是给两个路由加上不同的固定前缀，让路径结构明确区分：

@GetMapping("/users/{id}") // 匹配 /users/123 这类请求
public ResponseEntity<User> getUserById(@PathVariable Long id) {
    // 业务逻辑实现
}

@GetMapping("/profiles/{username}") // 匹配 /profiles/john 这类请求
public ResponseEntity<UserProfile> getUserByUsername(@PathVariable String username) {
    // 业务逻辑实现
}

2. 利用路径变量的正则表达式约束 #

Spring MVC支持给路径变量添加正则表达式，通过匹配规则区分不同参数的格式：

// 仅匹配纯数字格式的id（如123、456）
@GetMapping("/{id:\\d+}")
public ResponseEntity<User> getUserById(@PathVariable Long id) {
    // 业务逻辑实现
}

// 匹配包含字母、数字、下划线的用户名（如john、alice_123）
@GetMapping("/{username:[a-zA-Z0-9_]+}")
public ResponseEntity<UserProfile> getUserByUsername(@PathVariable String username) {
    // 业务逻辑实现
}

注意：需根据实际业务规则调整正则表达式，避免出现匹配重叠的情况。

3. 使用请求参数区分（适用于非强路径变量场景） #

如果业务允许，可以将其中一个参数改为请求参数，规避路径冲突：

@GetMapping("/user")
public ResponseEntity<User> getUser(@RequestParam(required = false) Long id, 
                                   @RequestParam(required = false) String username) {
    if (id != null) {
        // 根据id查询的逻辑
    } else if (username != null) {
        // 根据username查询的逻辑
    }
    // 处理参数为空的异常情况
}

这种方式适合参数可选的场景，但路径可读性不如前两种方案。

4. 调整路由注册顺序（临时方案，不推荐） #

若必须保留原路径结构，可以调整两个路由的注册顺序，将匹配规则更具体的路由放在前面。但这种方式脆弱性高，后续代码维护时极易因顺序变动再次出现冲突，不建议长期使用。

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