Spring Boot使用java-dotenv无法从.env加载变量问题

问题根源：Spring Boot初始化上下文、加载application.properties的时机早于你在main方法里手动调用Dotenv读取变量的时机，导致Spring解析${DB_URL}这类占位符时，系统环境中还没有对应变量，最终出现配置解析失败的错误。

下面是两种可行的解决方法：

方法一：通过EnvironmentPostProcessor提前注入.env变量 #

这个方法利用Spring的扩展机制，在加载配置文件之前就把.env变量注入到Spring环境中，优先级高于默认配置：

1. 创建环境后置处理器类

import io.github.cdimascio.dotenv.Dotenv;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.env.EnvironmentPostProcessor;
import org.springframework.core.env.ConfigurableEnvironment;
import org.springframework.core.env.MapPropertySource;

import java.util.HashMap;
import java.util.Map;

public class DotenvEnvironmentPostProcessor implements EnvironmentPostProcessor {
    @Override
    public void postProcessEnvironment(ConfigurableEnvironment environment, SpringApplication application) {
        // 加载项目根目录的.env文件
        Dotenv dotenv = Dotenv.configure().load();
        Map<String, Object> envProperties = new HashMap<>();
        
        // 将.env中的所有变量存入Map
        dotenv.entries().forEach(entry -> envProperties.put(entry.getKey(), entry.getValue()));
        
        // 将自定义属性源添加到Spring环境最前面，确保占位符解析时优先使用这些变量
        environment.getPropertySources().addFirst(new MapPropertySource("dotenv", envProperties));
    }
}

2. 注册处理器
   在src/main/resources/META-INF目录下创建spring.factories文件，添加以下内容（替换com.yourpackage为你实际的包路径）：

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

方法二：在Spring应用启动前手动注入系统属性 #

直接在main方法中，启动Spring应用之前把.env变量写入系统属性，这样Spring解析配置时就能读取到：

import io.github.cdimascio.dotenv.Dotenv;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class YourApplication {
    public static void main(String[] args) {
        // 加载.env文件
        Dotenv dotenv = Dotenv.configure().load();
        
        // 将.env变量注入系统属性
        dotenv.entries().forEach(entry -> System.setProperty(entry.getKey(), entry.getValue()));
        
        // 启动Spring应用
        SpringApplication.run(YourApplication.class, args);
    }
}

注意事项 #

• 确认.env文件放在项目根目录（和pom.xml/build.gradle同级），如果需要指定路径，可使用Dotenv.configure().directory("自定义路径").load()
• 检查.env中的变量名和application.properties里的占位符完全匹配，变量名大小写敏感（比如DB_URL不能写成db_url）
• 不要在配置文件中硬编码敏感信息，始终通过.env管理这类变量

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