Spring Boot请求体中能否使用枚举类型字段及如何校验？

一、请求体中能否使用枚举字段？ #

当然可以。Spring Boot默认的Jackson序列化组件会自动完成字符串与枚举的转换：当请求体传入枚举常量的名称（如"A"、"B"）时，Jackson会自动映射为对应的Status枚举实例；如果传入的字符串不在枚举常量范围内，会直接抛出HttpMessageNotReadableException异常。

二、如何通过Spring Validation校验枚举字段？ #

以下是几种实用的校验方案，可根据场景选择：

方案1：自定义通用枚举校验注解（推荐复用场景） #

这种方式适合需要在多个地方复用枚举校验逻辑的场景，灵活性最高。

1. 定义校验注解

import javax.validation.Constraint;
import javax.validation.Payload;
import java.lang.annotation.*;

@Documented
@Constraint(validatedBy = EnumValidator.class)
@Target({ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
public @interface ValidEnum {
    String message() default "无效的枚举值";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
    Class<? extends Enum<?>> enumClass();
}

2. 实现校验逻辑

import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;
import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;

public class EnumValidator implements ConstraintValidator<ValidEnum, String> {
    private List<String> allowedValues;

    @Override
    public void initialize(ValidEnum constraintAnnotation) {
        Class<? extends Enum<?>> enumClass = constraintAnnotation.enumClass();
        allowedValues = Arrays.stream(enumClass.getEnumConstants())
                .map(Enum::name)
                .collect(Collectors.toList());
    }

    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        // 若允许字段为空，可添加判断：if (value == null) return true;
        return allowedValues.contains(value);
    }
}

3. 在实体类中应用注解
   修改Order类，给status字段加上校验注解：

@Getter
@Setter
@NoArgsConstructor
public class Order{
    @ValidEnum(enumClass = Status.class, message = "status的有效值为A、B、C")
    private Status status;
}

方案2：使用@Pattern注解（简单固定场景） #

如果枚举常量数量少且不会频繁变动，可以直接用正则表达式匹配枚举名称：

@Getter
@Setter
@NoArgsConstructor
public class Order{
    @Pattern(regexp = "^(A|B|C)$", message = "status必须是A、B、C中的一个")
    private Status status;
}

注意：枚举新增常量时需要同步修改正则，维护成本较高，仅适合简单场景。

方案3：基于枚举自身的校验逻辑（快速实现） #

可以在枚举中添加静态校验方法，结合@AssertTrue注解完成校验：

1. 扩展枚举类

public enum Status{
    A, B, C;

    public static boolean isValid(String value) {
        if (value == null) return false;
        try {
            Status.valueOf(value);
            return true;
        } catch (IllegalArgumentException e) {
            return false;
        }
    }
}

2. 在实体类中添加校验方法

@Getter
@Setter
@NoArgsConstructor
public class Order{
    private Status status;

    @AssertTrue(message = "status的有效值为A、B、C")
    private boolean isStatusValid() {
        return status != null && Status.isValid(status.name());
    }
}

这种方式无需额外编写自定义注解，适合快速实现简单校验需求。

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