Spring Boot接口中如何阻止Integer自动转换为Enum

你的核心问题是Jackson默认支持通过枚举的序号（ordinal）反序列化，导致"0"会被自动转为RED。要拦截这种转换，必须在反序列化阶段阻止序号匹配，只允许使用枚举名称（RED/BLUE/BROWN）。以下是几种可行方案：

方案1：自定义Jackson枚举反序列化器 #

直接控制枚举的反序列化逻辑，强制只匹配枚举名称：

1. 编写自定义反序列化器

import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.databind.DeserializationContext;
import com.fasterxml.jackson.databind.deser.std.StdDeserializer;
import java.io.IOException;

public class StrictColorEnumDeserializer extends StdDeserializer<ColorEnum> {

    public StrictColorEnumDeserializer() {
        super(ColorEnum.class);
    }

    @Override
    public ColorEnum deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        String value = p.getText().trim();
        try {
            // 仅允许通过枚举名称匹配，拒绝序号
            return ColorEnum.valueOf(value);
        } catch (IllegalArgumentException e) {
            throw new IOException("无效的颜色值: " + value + "，仅支持RED、BLUE、BROWN");
        }
    }
}

2. 在枚举字段上添加注解指定反序列化器

public class YourRequestClass {
    @JsonDeserialize(using = StrictColorEnumDeserializer.class)
    private ColorEnum color;

    // getter、setter
}

方案2：在枚举中自定义反序列化入口 #

通过@JsonCreator指定自定义的转换方法，拒绝序号类值：

public enum ColorEnum {
    RED, BLUE, BROWN;

    @JsonCreator
    public static ColorEnum fromString(String value) {
        try {
            return ColorEnum.valueOf(value);
        } catch (IllegalArgumentException e) {
            throw new IllegalArgumentException("无效的颜色值: " + value + "，仅支持RED、BLUE、BROWN");
        }
    }
}

Jackson会优先调用这个fromString方法进行反序列化，当传入"0"时会直接抛出异常。

方案3：全局配置Jackson禁用序号反序列化 #

如果希望所有枚举都禁止通过序号反序列化，可以在Spring Boot中全局配置：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.DeserializationFeature;

@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper objectMapper() {
        ObjectMapper objectMapper = new ObjectMapper();
        // 禁用通过序号反序列化枚举
        objectMapper.disable(DeserializationFeature.READ_ENUMS_USING_INDEX);
        // 强制枚举反序列化时严格匹配名称，拒绝数字类值
        objectMapper.enable(DeserializationFeature.FAIL_ON_NUMBERS_FOR_ENUMS);
        return objectMapper;
    }
}

其中FAIL_ON_NUMBERS_FOR_ENUMS会阻止将数字（包括字符串形式的数字）转换为枚举，直接抛出异常。

为什么自定义isValid()注解无效？ #

因为注解校验是在反序列化完成后执行的，此时"0"已经被转换为RED枚举值，校验逻辑看到的是合法的枚举实例，自然不会触发异常。必须在反序列化阶段拦截才能解决问题。

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