如何在枚举字段唯一性校验失败时阻止Spring Boot应用启动

当前枚举的静态初始化块仅在枚举类第一次被加载时执行，若Spring Boot启动过程中未触发枚举加载，校验逻辑就不会运行，无法阻止应用启动。以下是几种可靠的实现方案：

方案1：通过ApplicationRunner触发校验 #

创建Spring配置类，利用ApplicationRunner在应用启动阶段主动触发枚举的校验逻辑：

import org.springframework.boot.ApplicationRunner;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class EnumValidationConfig {

    @Bean
    public ApplicationRunner enumValidationRunner() {
        return args -> {
            // 主动访问枚举，触发静态块或校验方法执行
            MyEnum.values();
        };
    }
}

一旦校验失败抛出异常，Spring Boot会直接终止启动流程。

方案2：使用ApplicationContextInitializer（更早执行） #

如果需要在Spring容器初始化的更早阶段执行校验，可自定义初始化器：

import org.springframework.context.ApplicationContextInitializer;
import org.springframework.context.ConfigurableApplicationContext;

public class EnumValidationInitializer implements ApplicationContextInitializer<ConfigurableApplicationContext> {

    @Override
    public void initialize(ConfigurableApplicationContext applicationContext) {
        // 触发枚举校验逻辑
        MyEnum.values();
    }
}

随后在src/main/resources/META-INF/spring.factories中注册该初始化器：

org.springframework.context.ApplicationContextInitializer=com.yourpackage.EnumValidationInitializer

此方式会在Spring容器创建前执行校验，失败则直接中断应用启动。

方案3：重构枚举校验逻辑（更清晰） #

将校验逻辑从静态块抽为独立静态方法，便于调用和维护：

import java.util.Arrays;

public enum MyEnum {
    VALUE_1(1),
    VALUE_2(1),
    VALUE_3(3);

    private int code;

    MyEnum(int code) {
        this.code = code;
    }

    public int getCode() {
        return code;
    }

    public static void validateUniqueCodes() {
        long uniqueCodesCount = Arrays.stream(MyEnum.values())
                .map(MyEnum::getCode)
                .distinct()
                .count();
        if (MyEnum.values().length != uniqueCodesCount) {
            throw new IllegalStateException("枚举code存在重复，应用启动失败");
        }
    }
}

再在ApplicationRunner中调用该方法：

@Bean
public ApplicationRunner enumValidationRunner() {
    return args -> MyEnum.validateUniqueCodes();
}

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