Spring Boot中用.env文件配置数据库连接信息的方案及最佳实践

一、修复你当前的Dotenv实现 #

你的问题出在Spring无法识别${dotenv.get('DB_URL')}这种占位符写法，需要把Dotenv加载的变量注入到Spring的环境变量中，具体修改如下：

1. 修改EnvConfig.java，实现EnvironmentPostProcessor接口，将.env中的变量添加到Spring环境：

@Configuration
public class EnvConfig implements EnvironmentPostProcessor {

    @Override
    public void postProcessEnvironment(ConfigurableEnvironment environment, SpringApplication application) {
        Dotenv dotenv = Dotenv.configure().ignoreIfMissing().load();
        dotenv.entries().forEach(entry -> {
            // 将dotenv变量优先级设为最高，避免被其他配置覆盖
            environment.getPropertySources().addFirst(
                new MapPropertySource("dotenv", Collections.singletonMap(entry.getKey(), entry.getValue()))
            );
        });
    }
}

2. 在项目的src/main/resources/META-INF目录下创建spring.factories文件，注册这个环境处理器：

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

（注意替换com.yourpackage为你的实际包路径）

3. 修改application.properties，直接用变量名引用：

spring.datasource.url=${DB_URL}
spring.datasource.username=${DB_USER}
spring.datasource.password=${DB_PASS}

这样就能正常加载.env中的配置了。

二、更优方案：使用Spring Boot原生支持加载.env文件 #

不需要引入第三方Dotenv依赖，Spring Boot 2.4+版本原生支持加载.env文件，步骤更简单：

1. 确保你的.env文件是标准的键值对格式（和properties一致），比如：

DB_URL=jdbc:mysql://localhost:3306/your_db
DB_USER=root
DB_PASS=your_password

2. 在application.properties中添加配置导入语句：

# optional表示如果.env文件不存在也不会报错
spring.config.import=optional:file:.env[.properties]

3. 同样在application.properties中直接引用变量即可，和上面的写法一致：

spring.datasource.url=${DB_URL}
spring.datasource.username=${DB_USER}
spring.datasource.password=${DB_PASS}

这种方式减少了第三方依赖，更符合Spring Boot的生态规范。

三、最佳实践 #

1. 优先使用Spring原生配置体系：尽量避免引入额外依赖，利用Spring Boot自带的配置加载能力，降低维护成本。
2. 环境隔离：不同环境（开发、测试、生产）使用独立的配置文件，比如application-dev.properties、application-prod.properties，通过激活对应Profile（spring.profiles.active=dev）切换，不要在.env中混合多环境配置。
3. 敏感信息安全：
   • 本地开发用.env没问题，但绝对不要把.env文件提交到版本控制，一定要加入.gitignore。
   • 生产环境不建议用.env存储敏感信息，优先使用专业的密钥管理服务（比如HashiCorp Vault、云服务商的密钥管理），或者Spring Cloud Config配合加密功能，避免敏感信息泄露。
4. 配置优先级：了解Spring Boot的配置加载优先级，确保.env中的变量不会被其他低优先级配置覆盖（比如上面的方案中把dotenv变量设为最高优先级）。

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