如何在无法注入指定路径Resource时阻止Spring Boot应用启动？

当你用@Value("classpath:...")注入Resource时，Spring默认不会校验资源是否存在——它只会创建一个指向该路径的Resource对象，哪怕路径无效。要在资源缺失时阻止应用启动，有几种直接的实现方式：

方法一：在Bean初始化时校验（@PostConstruct） #

在注入资源的业务Bean里，用@PostConstruct注解的方法做存在性校验，一旦资源不存在就抛出异常，Spring会因Bean初始化失败终止启动：

import org.springframework.core.io.Resource;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Service;
import javax.annotation.PostConstruct;

@Service
public class InsuranceTemplateService {

    @Value("classpath:insurance/template/insurance_policy.docx")
    private Resource policyTemplate;

    @PostConstruct
    public void checkTemplateExists() {
        if (!policyTemplate.exists()) {
            throw new IllegalStateException("必须的模板文件不存在：insurance/template/insurance_policy.docx");
        }
    }
}

方法二：用配置类做全局校验（@ConditionalOnMissingResource） #

如果不想把校验逻辑和业务Bean绑定，可以单独写一个配置类，利用Spring Boot的条件注解，当资源缺失时主动抛出异常：

import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingResource;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class TemplateValidationConfig {

    @Bean
    @ConditionalOnMissingResource(resources = "classpath:insurance/template/insurance_policy.docx")
    public Object validateTemplatePresence() {
        throw new IllegalStateException("类路径中缺少必填的保险单模板文件");
    }
}

这个配置类会在资源不存在时创建一个抛出异常的Bean，导致上下文加载失败，直接终止应用启动。

方法三：用启动回调校验（ApplicationRunner） #

也可以用ApplicationRunner在应用启动完成前做校验，抛出异常同样会让Spring Boot退出：

import org.springframework.core.io.Resource;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.ApplicationRunner;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class StartupValidationConfig {

    @Value("classpath:insurance/template/insurance_policy.docx")
    private Resource policyTemplate;

    @Bean
    public ApplicationRunner templateValidationRunner() {
        return args -> {
            if (!policyTemplate.exists()) {
                throw new IllegalStateException("保险单模板文件未找到，应用无法启动");
            }
        };
    }
}

原理说明 #

不管用哪种方法，核心都是在Spring应用上下文加载过程中抛出未捕获的异常——Spring Boot检测到Bean初始化或启动回调失败时，会自动终止应用启动流程，避免无效的服务运行。

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