spring boot 默认将重复的查询参数合并为逗号分隔字符串，但可通过 @requestparam multivaluemap 显式捕获原始多值结构，并在控制器中校验重复项，一旦发现重复即抛出 400 bad request。
spring boot 默认将重复的查询参数合并为逗号分隔字符串，但可通过 @requestparam multivaluemap 显式捕获原始多值结构，并在控制器中校验重复项，一旦发现重复即抛出 400 bad request。
在 Spring Boot 中，默认情况下，当客户端发送如 /my-api?foo=abc&foo=def 这样的请求时，框架会自动将多个同名查询参数聚合为单个以逗号分隔的字符串（例如 "abc,def"），从而丢失原始参数数量信息。但业务场景中常需严格校验——**禁止同一参数出现多次**，此时必须还原并检查原始参数结构。最简洁、可靠的方式是在控制器方法中直接注入 MultiValueMap<String, String>，它能完整保留每个参数名对应的所有原始值（包括重复项）：
@GetMapping("/my-api")
public ResponseEntity<String> handleRequest(
@RequestParam MultiValueMap<String, String> parameters) {
// 检查任意参数是否出现超过一次
boolean hasDuplicate = parameters.values().stream()
.anyMatch(values -> values.size() > 1);
if (hasDuplicate) {
throw new ResponseStatusException(
HttpStatus.BAD_REQUEST,
"Duplicate query parameters are not allowed");
}
// 正常业务逻辑（可安全提取单值参数）
String foo = parameters.getFirst("foo"); // 安全获取首个值
return ResponseEntity.ok("Processed: " + foo);
}⚠️ 注意事项：
- MultiValueMap 会捕获所有查询参数（含未声明的），适合全局校验；若仅需校验特定参数，可改用 parameters.get("paramName") 单独判断；
- 不要混用 @RequestParam String param 和 MultiValueMap 同一参数，否则 Spring 会抛出 IllegalStateException；
- 如需全局统一处理（避免每个接口重复校验），可结合 HandlerInterceptor 或自定义 @ControllerAdvice 实现前置校验；
- 该方案不依赖额外依赖或配置，兼容 Spring Boot 2.x / 3.x，且语义清晰、调试友好。
总结：虽无开箱即用的注解（如 @NoDuplicateParams），但利用 MultiValueMap 是轻量、标准且符合 Spring 设计哲学的解决方案——它让开发者在保持类型安全的同时，精准掌控 HTTP 请求的原始语义。
