Spring REST应用Ambiguous handler methods映射冲突如何解决

报错原因和你的推测完全一致：getAllUsers()与调整后的getUserByName()同时绑定了GET /users路径，Spring MVC启动阶段检测到同一HTTP方法、同一路径对应多个处理方法，判定为歧义映射直接抛出异常。
另外你最初遇到的「无法区分路径参数是String还是Integer」问题，本质是Spring MVC默认不会根据@PathVariable的参数类型做路由匹配，只要URL路径段结构一致，即使参数类型不同也会被判定为重复映射。

方案1：路径拆分（推荐，符合RESTful设计规范） #

给用户名查询接口单独分配独立子路径，同时给ID路径参数增加数字正则校验，从根本上避免路径冲突。修正后代码如下：

@RestController
@RequestMapping("/users")
public class UserController {

    private final UserRepository userRepository;

    // Spring 4.3+ 单构造器无需显式添加@Autowired即可完成依赖注入
    public UserController(UserRepository userRepository) {
        this.userRepository = userRepository;
    }

    // 全量用户列表：GET /users
    @GetMapping
    public List<User> getAllUsers() {
        return userRepository.findAll();
    }

    // 按ID查询用户：仅匹配纯数字路径段，避免和其他路径规则冲突
    @GetMapping(value = "/{id:\\d+}")
    public ResponseEntity<User> getUserById(@PathVariable Long id) {
        User user = userRepository.findById(id);
        return ResponseEntity.ok(user);
    }

    // 按用户名查询用户：独立子路径，通过请求参数传值
    @GetMapping(value = "/name")
    public ResponseEntity<User> getUserByName(@RequestParam(value = "name") String name) {
        User user = userRepository.findUserByName(name);
        return ResponseEntity.ok(user);
    }
}

对应访问路径：

• 全量用户列表：http://localhost:8080/users
• 按ID查询用户：http://localhost:8080/users/1
• 按用户名查询用户：http://localhost:8080/users/name?name=john

方案2：同路径合并逻辑（适配你最初的路径预期） #

如果你希望保持GET /users?name=xxx的访问形式，不需要给名称查询加子路径，可以把两个同路径的方法合并，通过判断请求参数是否存在走不同分支逻辑。代码如下：

@RestController
@RequestMapping("/users")
public class UserController {

    private final UserRepository userRepository;

    public UserController(UserRepository userRepository) {
        this.userRepository = userRepository;
    }

    // 同一路径处理两类请求：传name参数查单个用户，不传返回全量列表
    @GetMapping
    public ResponseEntity<?> getUsers(@RequestParam(value = "name", required = false) String name) {
        if (name != null) {
            User user = userRepository.findUserByName(name);
            return ResponseEntity.ok(user);
        }
        return ResponseEntity.ok(userRepository.findAll());
    }

    @GetMapping(value = "/{id:\\d+}")
    public ResponseEntity<User> getUserById(@PathVariable Long id) {
        User user = userRepository.findById(id);
        return ResponseEntity.ok(user);
    }
}

对应访问路径和你最初的预期完全一致：

• 全量用户列表：http://localhost:8080/users
• 按ID查询用户：http://localhost:8080/users/1
• 按用户名查询用户：http://localhost:8080/users?name=john

注意：该方案会将两类业务逻辑耦合在同一个方法中，后续如果新增其他筛选参数（比如按年龄、注册时间过滤），方法复杂度会快速上升，可维护性不如方案1。

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