Spring Boot运行时检查环境变量是否存在并按需获取以避免启动报错

阿华AIGC实验室

2026-5-14

问题背景

我有一个Spring Boot应用，客户端设置的部分环境变量已配置在application.properties中，目前所有客户端使用相同变量都运行正常。但现在遇到一个场景：部分客户端可能不需要配置某个特定变量，仅部分客户端需要配置它。我想用同一套代码适配所有客户端，但当前应用引用不存在的变量时会启动报错，报错信息如下：

Unsatisfied dependency expressed through field 'config'; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'configClass': Injection of autowired dependencies failed; nested exception is java.lang.IllegalArgumentException: Could not resolve placeholder 'X' in value "${INFO}"

想请教下有没有办法检查环境变量是否存在，仅在存在时获取其值？

解决方案

当然有办法啦！Spring Boot提供了好几种灵活的方式来处理这种可选配置的场景，下面给你介绍几个常用的方案：

1. 使用`@Value`注解的默认值特性

这是最简单直接的方式，你可以在@Value注解里为变量指定一个默认值，当目标环境变量不存在时，应用就会自动使用这个默认值，不会触发启动报错。示例代码如下：

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;

@Component
public class ConfigClass {
    // 当INFO变量不存在时，会使用空字符串作为默认值
    @Value("${INFO:}")
    private String info;

    // 如果你希望默认值是null，也可以这么写
    // @Value("${INFO:#{null}}")
    // private String info;

    public void doBusinessLogic() {
        if (info != null && !info.isEmpty()) {
            // 仅当INFO变量存在且非空时执行对应逻辑
            System.out.println("使用配置的INFO值: " + info);
        } else {
            // 变量未配置时的默认处理逻辑
            System.out.println("INFO变量未配置，执行默认流程");
        }
    }
}

这里的${INFO:}表示如果找不到INFO这个占位符，就用空字符串兜底；${INFO:#{null}}则会用null作为默认值，你可以根据业务需求选择合适的默认值。

2. 注入`Environment`对象主动检查配置

如果需要更灵活的判断逻辑，你可以直接注入Spring的Environment对象，通过它的containsProperty()方法先判断变量是否存在，再决定是否获取值：

import org.springframework.core.env.Environment;
import org.springframework.stereotype.Component;

@Component
public class ConfigClass {
    private final Environment environment;

    // 通过构造方法注入Environment
    public ConfigClass(Environment environment) {
        this.environment = environment;
    }

    public void doBusinessLogic() {
        if (environment.containsProperty("INFO")) {
            String info = environment.getProperty("INFO");
            System.out.println("使用配置的INFO值: " + info);
        } else {
            System.out.println("INFO变量未配置，执行默认流程");
        }
    }
}

这种方式适合需要结合多个配置项做复杂分支判断的场景，灵活性更高。

3. 使用`@ConfigurationProperties`配合条件注解

如果你的配置项比较多，推荐用@ConfigurationProperties来统一绑定配置，再结合@ConditionalOnProperty来控制Bean的创建或逻辑生效：
首先创建配置类：

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@Component
@ConfigurationProperties(prefix = "custom") // 假设配置前缀为custom，对应custom.info
public class CustomConfig {
    private String info;

    // Getter和Setter方法
    public String getInfo() {
        return info;
    }

    public void setInfo(String info) {
        this.info = info;
    }
}

之后在业务代码中判断配置是否存在：

import org.springframework.stereotype.Service;

@Service
public class BusinessService {
    private final CustomConfig customConfig;

    public BusinessService(CustomConfig customConfig) {
        this.customConfig = customConfig;
    }

    public void process() {
        String info = customConfig.getInfo();
        if (info != null && !info.isEmpty()) {
            // 处理配置存在的业务逻辑
        } else {
            // 处理配置不存在的默认逻辑
        }
    }
}

你还可以用@ConditionalOnProperty来控制特定Bean的创建，比如只有当custom.info存在时才创建某个服务：

import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
import org.springframework.stereotype.Component;

@Component
@ConditionalOnProperty(name = "custom.info", matchIfMissing = false)
public class InfoRelatedService {
    public void handleInfo(String info) {
        System.out.println("处理INFO配置: " + info);
    }
}

这种方式更适合配置项较多的场景，管理起来更清晰规范。

总结

以上几种方案都能解决你的问题：