通过 @RequestParam(required = false) 实现单接口灵活路由：当参数为空时返回全量数据，非空时精确查询单条记录，避免重复定义 REST 端点。
通过 `@requestparam(required = false)` 实现单接口灵活路由：当参数为空时返回全量数据，非空时精确查询单条记录，避免重复定义 rest 端点。
在 Spring Boot 中，为「查询全部」和「根据 ID 查询单条」分别设计两个接口（如 /users 和 /users/{id}）虽符合 REST 规范，但在某些轻量场景或前端统一调用需求下，开发者更倾向复用同一端点（如 /api/users/fetch），仅通过请求参数动态切换行为。这不仅简化前端逻辑，也降低接口维护成本。
实现的关键在于将 ID 设为可选请求参数，并在控制器中做条件分发：
@GetMapping("/api/users/fetch")
public ResponseEntity<?> fetchUsers(@RequestParam(required = false) String id) {
if (id == null || id.trim().isEmpty()) {
// 全量查询：返回 List<User>
return ResponseEntity.ok(userService.findAll());
} else {
// 单条查询：返回 Optional<User> 或封装为 List（含 0 或 1 个元素）
return userService.findById(id)
.map(user -> ResponseEntity.ok(List.of(user)))
.orElse(ResponseEntity.ok(List.of())); // 未找到时返回空列表
}
}✅ 注意事项：
- 使用 @GetMapping 替代泛化的 @RequestMapping，语义更清晰；
- required = false 是必需的，否则无参请求会直接报 400 错误；
- 建议对 id 执行 trim() 防止空格导致误判；
- 返回类型统一为 List<User> 可保持前端解析一致性（无需判断单对象/数组）；
- 若业务要求严格区分响应结构（如单查返回对象、全查返回数组），应考虑使用不同状态码或包装类，但需同步调整前端适配逻辑。
该方案简洁高效，适用于原型开发、内部工具或对 REST 纯度容忍度较高的项目。若系统规模扩大或需遵循 OpenAPI 规范，仍推荐拆分为语义明确的 /users（GET）与 /users/{id}（GET）标准端点。
