spring boot 默认将重复查询参数合并为逗号分隔字符串，但可通过 @requestparam multivaluemap 捕获原始多值结构，在控制器中校验并主动拒绝含重复参数的请求。
spring boot 默认将重复查询参数合并为逗号分隔字符串，但可通过 @requestparam multivaluemap 捕获原始多值结构，在控制器中校验并主动拒绝含重复参数的请求。
在 Spring Boot Web 应用中，当客户端发送形如 /my-api?foo=value1&foo=value2 的请求时，框架默认会将多个同名查询参数聚合为单个字符串（如 "value1,value2"），或通过 List<String> 接收——但这已丢失“是否重复”的原始语义信息，无法区分「合法多值」与「非法重复提交」。而业务场景中（如幂等性控制、防误操作、合规审计）常需严格禁止同一参数出现多次，此时必须在请求进入业务逻辑前完成检测。
最简洁可靠的实现方式是：使用 @RequestParam MultiValueMap<String, String> 直接获取原始参数键值对的多值映射。MultiValueMap 能完整保留每个参数名对应的所有原始值（包括重复项），从而支持精确校验。
以下是一个完整示例：
@RestController
@RequestMapping("/api")
public class ApiController {
@GetMapping("/my-api")
public ResponseEntity<String> handleRequest(
@RequestParam MultiValueMap<String, String> params) {
// 检查是否存在任一参数被重复传递（即 value 列表长度 > 1）
boolean hasDuplicateParam = params.values().stream()
.anyMatch(values -> values.size() > 1);
if (hasDuplicateParam) {
return ResponseEntity.badRequest()
.body("Duplicate query parameters are not allowed.");
}
// ✅ 此处可安全解析其他参数（如 @RequestParam String foo）
String foo = params.getFirst("foo"); // 获取首个值（若需）
return ResponseEntity.ok("Valid request: foo = " + foo);
}
}⚠️ 注意事项：
- MultiValueMap<String, String> 必须作为方法参数显式声明，并搭配 @RequestParam 注解（无属性值），Spring 会自动注入完整原始参数集合；
- 不要混用 MultiValueMap 与其他同名 @RequestParam 单值参数（如 @RequestParam String foo），否则将触发 IllegalStateException（参数绑定冲突）；
- 若需同时校验并提取参数，建议统一通过 MultiValueMap 获取后手动解析（如 params.getFirst("foo") 或 params.get("foo")），确保逻辑一致性；
- 此方案适用于所有 HTTP 方法（GET/HEAD 等），不依赖过滤器或 AOP，侵入性低、性能开销极小；
- 如需全局生效，可封装为自定义 HandlerMethodArgumentResolver，但对多数场景而言，控制器内校验已足够清晰且可控。
总结：虽然 Spring Boot 未提供开箱即用的注解（如 @DisallowDuplicateParams）来声明式约束，但借助 MultiValueMap 这一轻量级 API，仅需 2–3 行校验代码即可稳健满足需求，兼顾可读性、可维护性与生产可靠性。
