Spring Boot：如何移除继承方法中的RequestMapping映射

问题背景 #

通过通用抽象Controller实现标准化API映射，子类仅需继承即可复用CRUD方法，但在子类重写index方法添加分页参数时，因父类无参index方法的@GetMapping映射被继承，导致同一路径下存在两个映射方法，触发"There is already 'itemController' bean method"错误。

解决方案 #

方案一：通过@RequestMapping参数区分映射（兼容父类逻辑） #

修改父类无参index方法的映射条件，仅当请求不带page参数时生效：

@GetMapping(params = "!page")
@ResponseStatus(HttpStatus.OK)
public List<BrowseResponse> index() {
    return service.index();
}

子类带参index方法限定仅当请求包含page参数时生效：

@GetMapping(params = "page")
@ResponseStatus(HttpStatus.OK)
public List<LevelResponse> index(@RequestParam(defaultValue = "0") Integer page) {
    return service.index(page);
}

此方案保留了父类的默认无分页逻辑，同时支持子类的分页请求，两者映射条件互斥，不会冲突。

方案二：完全覆盖父类映射（仅保留子类方法） #

在子类中重写父类的无参index方法，添加永远无法匹配的映射条件，让父类原映射失效：

@Override
@GetMapping(params = "invalid-param")
public List<LevelResponse> index() {
    throw new UnsupportedOperationException("请使用带page参数的接口");
}

@GetMapping
@ResponseStatus(HttpStatus.OK)
public List<LevelResponse> index(@RequestParam(defaultValue = "0") Integer page) {
    return service.index(page);
}

此时只有子类的带参方法会处理GET请求，重写的无参方法因params条件永远不满足，不会被Spring MVC识别为有效映射。

方案三：重构父类方法，支持可选参数（最推荐） #

直接修改父类的index方法，支持可选的分页参数，避免子类重写Controller：

@GetMapping
@ResponseStatus(HttpStatus.OK)
public List<BrowseResponse> index(@RequestParam(required = false, defaultValue = "0") Integer page) {
    if (page != null && page >= 0) {
        return service.index(page);
    }
    return service.index();
}

同时调整抽象Service接口，新增index(Integer page)方法，默认实现可复用无参index()逻辑，需要分页的子类Service只需实现该方法即可。这种方式最大化复用父类代码，无需子类修改Controller。

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