Spring Boot打包Jar遇环境变量解析失败：BeanCreationException求助

问题原因 #

执行mvn clean install打包时，Spring上下文会被初始化（比如通过测试类或插件默认行为触发），此时本地环境未配置CLOUDINARY_URL等环境变量，导致@Value("${CLOUDINARY_URL}")无法解析占位符，进而触发Bean创建异常。

解决方案 #

方案1：给@Value添加默认值 #

在CustomBeansConfig类中，给@Value注解设置空值或测试用默认值，本地打包时不会因变量缺失报错，部署到AWS Beanstalk后，平台注入的环境变量会自动覆盖默认值：

@Configuration
public class CustomBeansConfig {

    // 空默认值，部署时Beanstalk的环境变量会填充实际值
    @Value("${CLOUDINARY_URL:}")
    private String cloudinaryUrl;

    @Bean
    public Cloudinary cloudinary(){
        // 可选：部署前可添加校验，避免空值导致运行异常
        if (cloudinaryUrl == null || cloudinaryUrl.isEmpty()) {
            throw new IllegalStateException("CLOUDINARY_URL环境变量未配置");
        }
        return new Cloudinary(cloudinaryUrl);
    }
}

方案2：跳过测试类执行 #

如果打包失败是因为测试类启动了Spring上下文，直接执行打包命令时跳过测试环节：

mvn clean install -DskipTests

这样Maven不会运行测试代码，也就不会初始化Spring上下文，自然不会触发环境变量解析异常。

方案3：本地临时配置环境变量 #

在本地终端临时设置环境变量后再执行打包（Linux/macOS示例）：

export CLOUDINARY_URL="cloudinary://your-test-key:your-test-secret@your-test-cloud"
export MONGODB_URI="mongodb://localhost:27017/test-db"
export JWT_SECRET="test-secret"
mvn clean install

Windows终端则使用set命令：

set CLOUDINARY_URL=cloudinary://your-test-key:your-test-secret@your-test-cloud
mvn clean install

额外说明 #

• application.properties中的CLOUDINARY_URL=${CLOUDINARY_URL}可以保留，Spring会优先读取系统环境变量，而非配置文件中的占位符。
• 部署到AWS Beanstalk后，需在平台的环境变量配置中正确设置CLOUDINARY_URL、MONGODB_URI、JWT_SECRET等参数，Spring会自动注入这些值。

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