在 Spring Boot REST API 中，可通过 @EnumFormat 注解对请求体中的枚举字段进行合法性校验，确保客户端传入的值严格匹配预定义的枚举常量，避免无效字符串导致的运行时异常。
在 spring boot rest api 中，可通过 `@enumformat` 注解对请求体中的枚举字段进行合法性校验，确保客户端传入的值严格匹配预定义的枚举常量，避免无效字符串导致的运行时异常。
在构建 RESTful 接口时，将请求体（@RequestBody）中的字符串自动绑定为 Java 枚举类型虽便捷，但默认情况下 Spring 并不校验该字符串是否为合法枚举值——若客户端传入 "UNKNOWN" 或空格字符串等非法值，Spring 会抛出 MethodArgumentTypeMismatchException（如 IllegalArgumentException: No enum constant Level.UNKNOWN），且该异常发生在数据绑定阶段，早于 Bean Validation 的校验流程，因此 @NotNull、@NotBlank 等标准注解均无法捕获此类错误。
✅ 正确解决方案：使用 Spring Boot 官方支持的 @EnumFormat 注解（属于 Spring Framework 5.2+ 内置的格式化校验能力，无需额外引入 Hibernate Validator）：
public class CarDto {
@EnumFormat(enumClass = Level.class, message = "Level must be one of: NEW, OLD")
private Level level;
// getter/setter
}⚠️ 注意事项：
- @EnumFormat 是 Spring 自带注解（位于 org.springframework.format.annotation.EnumFormat），无需添加 hibernate-validator 依赖（该依赖常被误传；实际 @EnumFormat 与 Hibernate Validator 无关）；
- 必须配合 @Valid 或 @Validated 在 Controller 方法参数上启用校验：
@PostMapping("/cars") public ResponseEntity<?> createCar(@Valid @RequestBody CarDto carDto) { return ResponseEntity.ok(carDto); } - 若未配置全局异常处理器，非法枚举值将触发 MethodArgumentNotValidException，可通过 @ControllerAdvice 统一返回友好错误响应；
- enumClass 属性必须显式指定（不可省略），以明确校验目标枚举类型；
- 该注解仅校验字符串能否成功转换为枚举实例，不校验 null 值——如需同时禁止 null，应叠加 @NotNull：
@NotNull(message = "Level cannot be null") @EnumFormat(enumClass = Level.class, message = "Invalid level value") private Level level;
? 补充说明：若项目已集成 Hibernate Validator 且希望复用统一校验机制，也可自定义 @Constraint 实现枚举校验（如 @ValidEnum），但 @EnumFormat 更轻量、语义更清晰，是 Spring Boot 场景下的推荐方案。
