Spring @RequestMapping可选参数问题：控制器请求映射参数配置求助

我来帮你梳理一下问题所在以及对应的解决办法：

问题根源 #

你当前的代码存在逻辑冲突：第二个@GetMapping使用了params = {"from", "to"}属性，这个配置的作用是只有当请求同时携带from和to两个参数时，才会匹配到该方法，但你又把@RequestParam的required设为false（可选参数），这就导致了规则矛盾。如果用户只传其中一个参数，会出现两个方法都无法匹配的情况，最终触发404或者请求处理方法歧义的错误。

解决方案 #

这里提供两种常用的处理方式，你可以根据业务需求选择：

方案1：合并为单个方法处理所有场景

这种方式更简洁，把有无参数的逻辑整合到同一个方法中，通过判断参数是否为空来分支处理：

@GetMapping(produces = MediaType.APPLICATION_JSON_VALUE)
public ResponseEntity<List<Books>> getBooks(
    @RequestParam(value = "from", required = false) String fromDate,
    @RequestParam(value = "to", required = false) String toDate
) {
    // 同时携带两个日期参数时，调用范围查询逻辑
    if (fromDate != null && toDate != null) {
        return ResponseEntity.ok().body(booksService.getBooksByFromToDate(fromDate, toDate));
    } 
    // 无参数或仅携带单个参数时，返回全部书籍（也可根据需求扩展单个参数的逻辑）
    else {
        return ResponseEntity.ok().body(booksService.getBooks());
    }
}

方案2：保留两个方法，修正匹配规则

如果一定要拆分方法，需要明确每个方法的匹配条件，避免冲突：

// 仅匹配完全没有from和to参数的请求
@GetMapping(
    produces = MediaType.APPLICATION_JSON_VALUE,
    params = {"!from", "!to"}
)
public ResponseEntity<List<Books>> getBooks() {
    return ResponseEntity.ok().body(booksService.getBooks());
}

// 匹配携带from、to，或其中任意一个参数的请求
@GetMapping(produces = MediaType.APPLICATION_JSON_VALUE)
public ResponseEntity<List<Books>> getBooksByDateRange(
    @RequestParam(value = "from", required = false) String fromDate,
    @RequestParam(value = "to", required = false) String toDate
) {
    // 根据实际参数情况处理不同逻辑
    if (fromDate != null && toDate != null) {
        return ResponseEntity.ok().body(booksService.getBooksByFromToDate(fromDate, toDate));
    } else if (fromDate != null) {
        // 处理仅传from参数的业务逻辑
        return ResponseEntity.ok().body(booksService.getBooksFromDate(fromDate));
    } else if (toDate != null) {
        // 处理仅传to参数的业务逻辑
        return ResponseEntity.ok().body(booksService.getBooksToDate(toDate));
    }
    // 理论上该分支不会被触发（已被第一个方法拦截），可返回错误或默认结果
    return ResponseEntity.badRequest().build();
}

额外提示 #

如果你的业务规则是只有同时传入from和to才执行日期范围查询，否则返回全部书籍，方案1会是更优选择，既减少了方法数量，也避免了请求匹配的潜在问题。

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