создать два метода для одного и того же шаблона URL с разными аргументами

У меня есть сценарий, в котором один URL-адрес serachUser может иметь два разных значения (параметр запроса) userId или UserName.

поэтому для этого я создал два метода

public String searchUserById(@RequestParam long userID, Model model) 
public ModelAndView searchUserByName(@RequestParam String userName)

Но я получаю исключение для неоднозначного сопоставления. Spring может каким-то образом справиться с этой ситуацией.

Вы можете использовать paramsпараметр для фильтрации по параметрам HTTP. В вашем случае это будет примерно так:

@RequestMapping(value = "/searchUser", params = "userID")
public String searchUserById(@RequestParam long userID, Model model) {
  // ...
}

@RequestMapping(value = "/searchUser", params = "userName")
public ModelAndView searchUserByName(@RequestParam String userName) {
  // ...
}

В любом случае, если параметр запроса null разрешен, если вы не передаете никакого значения, оно будет нулевым, тогда вы можете написать свою команду, например:

@RequestMapping(value = "/searchUser", params = {"userID","userName"})
public String searchUserById(@RequestParam long userID,@RequestParam String 
userName, 
Model model) {    
if(userID != null){
//..
}else{
// ...
}