Spring Boot无法读取.env文件内容的问题排查求助

问题场景 #

配置spring.config.import=optional:file:.env[.properties]后，应用能识别.env文件（修改配置会提示文件不存在），但读取其中的JWT_SECRET_KEY等变量时返回null。已尝试引入java-dotenv依赖、@Value/System.getenv()获取值、调整配置项、使用EnvFile插件等操作，均未解决。

核心排查与解决方法 #

1. 检查.env文件格式是否符合要求 #

Spring通过file:.env[.properties]导入时，会把.env当作Properties格式解析，注意以下几点：

• 键值对必须是KEY=VALUE格式，不能加引号（比如不能写JWT_SECRET_KEY="abc123"，要直接JWT_SECRET_KEY=abc123）
• 值中的特殊字符（如#、空格）需要用反斜杠转义，例如DB_PASSWORD=pwd\#123
• 文件中不能有多余的空行或注释格式错误（注释必须以#开头）

示例正确的.env内容：

JWT_SECRET_KEY=your_jwt_secret_string
DB_URL=jdbc:mysql://localhost:3306/test_db
DB_USERNAME=root

2. 移除java-dotenv依赖，避免与Spring原生机制冲突 #

Spring Boot 2.4+已原生支持通过spring.config.import导入.env文件，无需额外引入io.github.cdimascio:java-dotenv依赖——两种环境变量加载机制会互相干扰，导致变量无法正常读取。

直接在build.gradle中删除该依赖项：

// 删除此行
implementation 'io.github.cdimascio:java-dotenv:5.2.2'

3. 确认Spring Boot版本与配置正确性 #

• 确保使用Spring Boot 2.4及以上版本（你的Corretto-17环境适配Spring Boot 2.7+或3.x，满足要求）
• 保持spring.config.import配置简洁：

  # application.properties中仅保留此行即可
  spring.config.import=optional:file:.env[.properties]
  

  不要添加多余的JWT_SECRET_KEY=${JWT_SECRET_KEY}，这属于无效的循环引用配置。

4. 验证配置加载状态 #

编写一个简单的组件验证环境变量是否加载：

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

@Component
public class EnvValidator implements CommandLineRunner {
    private final Environment env;

    public EnvValidator(Environment env) {
        this.env = env;
    }

    @Override
    public void run(String... args) {
        String jwtSecret = env.getProperty("JWT_SECRET_KEY");
        System.out.println("加载的JWT_SECRET_KEY: " + jwtSecret);
    }
}

启动应用后查看控制台输出，如果仍为null，继续检查：

• .env文件是否确实在项目根目录（与build.gradle、settings.gradle同层级）
• Intellij运行配置的Working directory是否设置为项目根目录（Run Configuration → Configuration → Working directory）

5. 暂时关闭EnvFile插件 #

Intellij的EnvFile插件会独立加载环境变量，可能与Spring原生导入机制冲突。先关闭插件，仅用Spring的spring.config.import配置测试，确认是否能正常读取。

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