如何在Spring Boot中未找到指定属性时终止应用启动？

这是个很实用的需求——确保关键配置存在才能启动应用，避免因为缺失属性导致运行时故障。下面给你两种可靠的实现方式，不管属性是存在本地配置文件（如application.yml/application.properties）还是Spring Cloud Config远程仓库都能生效：

方法一：利用Spring Bean验证机制（简便推荐） #

这种方式借助Spring的@Validated和JSR-380验证注解，能快速实现必填属性的校验，且默认会在启动时抛出异常终止进程。

步骤1：创建配置属性类 #

import jakarta.validation.constraints.NotNull;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.validation.annotation.Validated;

@Validated
@ConfigurationProperties(prefix = "my.app")
public class AppRequiredProperties {
    // 标记该属性为必填，自定义错误提示信息
    @NotNull(message = "my.app.required-property 是必填属性，缺失将终止应用启动")
    private String requiredProperty;

    // Getter和Setter
    public String getRequiredProperty() {
        return requiredProperty;
    }

    public void setRequiredProperty(String requiredProperty) {
        this.requiredProperty = requiredProperty;
    }
}

步骤2：启用配置属性 #

在你的Spring Boot主类上添加@EnableConfigurationProperties注解，让Spring识别这个配置类：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.context.properties.EnableConfigurationProperties;

@SpringBootApplication
@EnableConfigurationProperties(AppRequiredProperties.class)
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

原理说明：当Spring加载属性时，会自动对标记了@Validated的Bean进行校验。如果my.app.required-property不存在或为空，会抛出ConstraintViolationException，Spring Boot默认会将这个异常视为启动失败，直接终止进程。不管属性来自本地文件还是Spring Cloud Config远程仓库，只要被加载到Spring的Environment中，就能被检测到。

方法二：自定义EnvironmentPostProcessor（更早拦截） #

如果需要在应用启动的更早阶段（Bean创建之前）检查属性，可以自定义EnvironmentPostProcessor，在环境加载完成后立即校验。

步骤1：实现EnvironmentPostProcessor #

import org.springframework.boot.SpringApplication;
import org.springframework.boot.env.EnvironmentPostProcessor;
import org.springframework.core.env.ConfigurableEnvironment;
import org.springframework.core.env.MissingRequiredPropertiesException;

public class RequiredPropertyCheckerPostProcessor implements EnvironmentPostProcessor {
    // 定义需要检查的必填属性键
    private static final String REQUIRED_PROPERTY_KEY = "my.app.required-property";

    @Override
    public void postProcessEnvironment(ConfigurableEnvironment environment, SpringApplication application) {
        String propertyValue = environment.getProperty(REQUIRED_PROPERTY_KEY);
        // 检查属性是否存在且非空
        if (propertyValue == null || propertyValue.trim().isEmpty()) {
            throw new MissingRequiredPropertiesException(
                "Required property '" + REQUIRED_PROPERTY_KEY + "' is missing. Application cannot start."
            );
        }
    }
}

步骤2：注册处理器 #

在项目的src/main/resources/META-INF目录下创建spring.factories文件，添加以下内容来注册自定义处理器：

org.springframework.boot.env.EnvironmentPostProcessor=com.yourpackage.RequiredPropertyCheckerPostProcessor

原理说明：EnvironmentPostProcessor是Spring Boot提供的扩展点，会在应用启动初期、Bean定义加载之前执行。这里直接从Environment中获取属性，不管属性源是本地还是远程，都能被检测到。一旦缺失，抛出MissingRequiredPropertiesException（Spring Boot原生异常），直接终止启动流程。

注意事项 #

• 不要给必填属性设置默认值：比如@Value("${my.app.required-property:}")这种写法会把空字符串视为有效值，导致校验失效。直接使用@Value("${my.app.required-property}")或不设置默认值。
• Spring Cloud Config场景：确保你的应用已经正确配置了Config客户端，能正常拉取远程配置。如果拉取远程配置失败本身会导致启动失败，若拉取成功但缺失指定属性，上述两种方法都能准确检测到。

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