在泛型抽象控制器中，子类需为特定场景（如分页）重载 @GetMapping 方法时，若直接重写会导致重复映射冲突；正确做法是通过 params 属性差异化约束请求条件，实现方法级映射覆盖而不触发 Spring 的重复注册警告。
在泛型抽象控制器中，子类需为特定场景（如分页）重载 `@getmapping` 方法时，若直接重写会导致重复映射冲突；正确做法是通过 `params` 属性差异化约束请求条件，实现方法级映射覆盖而不触发 spring 的重复注册警告。
在基于 Spring Boot 的 RESTful API 开发中，采用泛型抽象控制器（如 Controller<Entity, Id, ...>）统一管理 CRUD 映射，是提升代码复用性与可维护性的常用实践。然而，当某个具体子控制器（如 ItemController）需要为 index() 方法扩展额外参数（例如分页参数 page）时，直接重写同路径的 @GetMapping 方法会引发 Spring 启动异常：
There is already 'itemController' bean method
这是因为 Spring MVC 的 RequestMappingHandlerMapping 在扫描时，将父类与子类中签名不同但 URL 路径和 HTTP 方法完全一致的方法均视为候选映射——即使子类方法多了一个 @RequestParam 参数，只要其 @GetMapping 未加区分条件，Spring 就认为存在“重复映射”，仅保留第一个（通常是父类方法），并记录警告。
✅ 正确解决方案：利用 @GetMapping.params 实现条件化映射覆盖
@GetMapping（及所有 @XxxMapping）支持 params 属性，用于限定该方法仅在请求携带指定查询参数时才生效。这恰好可用于“分流”：让父类方法处理无参请求，子类方法处理带参请求，二者共存且互不干扰。
以 ItemController 为例，应这样重载 index()：
@RestController
@RequestMapping("/api/items")
public class ItemController extends Controller<Item, Long, ItemBrowseResponse, ItemShowResponse, ItemRequest, ItemRepository, ItemService> {
public ItemController(ItemService service) {
super(service);
}
// ✅ 仅当请求包含 'page' 参数时才匹配此方法
@GetMapping(params = "page")
@ResponseStatus(HttpStatus.OK)
public List<ItemBrowseResponse> index(@RequestParam(defaultValue = "0") Integer page) {
return service.index(page); // 调用支持分页的业务方法
}
// ✅ 父类的 @GetMapping() 仍有效：处理 /api/items（无参）
// ✅ 子类的 @GetMapping(params = "page") 也有效：处理 /api/items?page=1
}? 关键原理说明：
- @GetMapping 默认等价于 @GetMapping(params = {})，即不校验任何参数；
- @GetMapping(params = "page") 表示 必须存在名为 page 的查询参数（值可为空，如 ?page=）；
- 若请求为 /api/items（无参数），仅父类方法匹配；
- 若请求为 /api/items?page=2，则仅子类方法匹配，父类方法因 params 不满足被排除。
? 进阶技巧：
- 支持多参数约束：params = {"page", "size"}（必须同时存在 page 和 size）；
- 支持值匹配：params = "format=json"（要求 format 参数值严格等于 "json"）；
- 支持否定逻辑：params = "!sort"（要求 sort 参数不存在）。
⚠️ 注意事项：
- ❌ 不要使用 @Deprecated + @Override 组合试图“屏蔽”父类方法——Spring 仍会注册它；
- ❌ 避免在子类中添加 @GetMapping 但不设 params，否则必然冲突；
- ✅ 始终确保子类方法的业务逻辑与参数语义对齐（如分页方法应调用支持分页的 service.index(page)，而非忽略参数）；
- ✅ 若需同时支持 page 和 size，建议统一定义为 @GetMapping(params = {"page", "size"}) 并接收两个 @RequestParam。
通过 params 属性实现映射条件化，既保留了泛型控制器的简洁性，又赋予子类精准定制能力，是 Spring MVC 中符合设计原则且零侵入的优雅解法。
