Spring RestController请求映射歧义问题排查求助

你遇到的这个问题确实有点让人困惑——明明两个方法的请求路径和HTTP方法都不一样，却触发了映射歧义的错误。我之前在项目里也碰到过类似的情况，结合你的代码和错误提示，咱们来一步步分析原因和解决方案：

可能的原因及对应解决方法 #

1. Spring版本的映射解析bug #

从你的错误信息和代码来看，所有方法的method属性都用了数组形式（比如method = {RequestMethod.POST}），而某些旧版本的Spring Boot（尤其是1.x早期版本）在处理这种数组形式的请求方法指定时，会出现映射匹配的逻辑错误，误判不同路径的方法存在歧义。

解决方法：
把getAitList方法的method参数从数组改成单个值，去掉括号：

@ResponseBody
@RequestMapping(value = "getAitList", method = RequestMethod.GET)
public List<CommentAitVo> getAitList(@RequestParam(name = "receiverId") String receiverId, PageQuery query) {
    return aitService.getCommentAitRecordList(query, receiverId).getList();
}

如果这个方法有效，建议你把其他方法的method也改成非数组形式，同时考虑升级到稳定版的Spring Boot，避免类似的版本bug。

2. 请求路径的斜杠冲突 #

你的类上@RequestMapping是"/comment/ait/"（末尾带斜杠），而方法的value是"getAitList"，组合后的路径会是/comment/ait//getAitList（双斜杠）。虽然Spring通常会自动合并斜杠，但某些场景下会导致映射解析异常，触发歧义判断。

解决方法：
把类上的@RequestMapping去掉末尾的斜杠：

@Controller
@RequestMapping("/comment/ait")
public class AitController extends BaseController {
    // ... 其他方法
}

或者给方法的value加上开头的斜杠：

@RequestMapping(value = "/getAitList", method = {RequestMethod.GET})

3. 参数绑定的隐式冲突 #

当你给getAitList指定method = GET时，Spring会对参数绑定进行更严格的检查。你的PageQuery参数没有标注任何注解，Spring会尝试把请求中的所有参数自动绑定到这个对象的字段上。如果PageQuery里有和其他方法（比如delAit的id参数）重名的字段，Spring的映射处理器可能会误判这两个方法的请求匹配规则有重叠，从而抛出歧义错误。

解决方法：
给PageQuery参数加上@ModelAttribute注解，明确它是一个模型属性参数，避免和其他简单参数混淆：

@ResponseBody
@RequestMapping(value = {"getAitList"}, method = {RequestMethod.GET})
public List<CommentAitVo> getAitList(@RequestParam(name = "receiverId") String receiverId, @ModelAttribute PageQuery query) {
    return aitService.getCommentAitRecordList(query, receiverId).getList();
}

另外也可以检查PageQuery的字段，看看是否有和其他方法参数重名的情况，必要时修改字段名或者参数的name属性。

4. 重复的映射定义（隐藏坑） #

虽然你贴出来的代码里没有，但也要确认一下：

• 你的BaseController父类中是否有同名的getAitList方法，或者映射路径相同的方法？
• 实际代码中是否不小心重复定义了getAitList方法（比如复制粘贴时没改方法名）？

如果存在这种情况，只需要删除重复的方法或者修改映射路径即可。

验证方法 #

你可以先尝试第一种方法（修改method为非数组形式），因为这是最常见的原因，操作也最简单。如果解决了问题，就可以不用再排查其他方向；如果没解决，再依次尝试后面的方法。

内容的提问来源于stack exchange，提问作者陈小生