无法解析.env文件中的属性占位符？求助解决方案

Spring Boot默认不支持直接加载根目录的.env文件，因此会出现无法解析${APP_API_URL}的错误，以下是几种可行的解决办法：

方法一：使用spring-boot-dotenv依赖（推荐） #

这是最简便的实现方式，该依赖会自动加载项目根目录的.env文件：

1. 添加依赖
   • Maven项目，在pom.xml中加入：

     <dependency>
         <groupId>me.paulschwarz</groupId>
         <artifactId>spring-boot-dotenv</artifactId>
         <version>2.5.0</version>
     </dependency>
     

   • Gradle项目，在build.gradle中加入：

     implementation 'me.paulschwarz:spring-boot-dotenv:2.5.0'
     

2. 确保.env文件位于项目根目录（与pom.xml/build.gradle同级），重启项目后，application.properties中的占位符即可正常解析。

方法二：手动加载.env文件 #

若不想引入额外依赖，可通过配置类手动将.env变量加载到系统属性中：

1. 添加dotenv-java依赖
   • Maven：

     <dependency>
         <groupId>io.github.cdimascio</groupId>
         <artifactId>dotenv-java</artifactId>
         <version>2.2.0</version>
     </dependency>
     

   • Gradle：

     implementation 'io.github.cdimascio:dotenv-java:2.2.0'
     

2. 创建配置类：

   import org.springframework.context.annotation.Configuration;
   import io.github.cdimascio.dotenv.Dotenv;
   import javax.annotation.PostConstruct;
   
   @Configuration
   public class DotenvConfig {
       @PostConstruct
       public void loadEnvVariables() {
           Dotenv dotenv = Dotenv.load();
           dotenv.entries().forEach(entry -> 
               System.setProperty(entry.getKey(), entry.getValue())
           );
       }
   }
   

项目启动时会自动加载.env中的变量，供application.properties引用。

方法三：直接设置系统环境变量 #

无需依赖，直接在运行时注入环境变量：

• IDE运行配置：在项目的运行配置中，添加环境变量APP_API_URL=http://localhost:8081
• 命令行启动：

  # Linux/macOS
  APP_API_URL=http://localhost:8081 mvn spring-boot:run
  
  # Windows（CMD）
  set APP_API_URL=http://localhost:8081 && mvn spring-boot:run
  
  # Windows（PowerShell）
  $env:APP_API_URL="http://localhost:8081"; mvn spring-boot:run
  

注意事项 #

• 检查.env文件的变量名是否拼写正确，确保APP_API_URL无大小写或拼写错误
• 确保.env文件使用UTF-8编码，避免因编码问题导致变量加载失败
• 若使用多环境配置，可通过指定DOTENV_LOCATION属性加载对应环境的.env文件（如.env.dev）

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