SpringBoot使用.env配置PostgreSQL失效，请求排查问题

核心问题梳理 #

你的配置存在三个关键问题，导致应用无法正常启动：

1. Spring Boot原生不支持.env文件，缺少解析依赖 #

Spring Boot默认没有内置.env文件的解析能力，必须添加第三方依赖来加载.env中的环境变量。

2. application.properties中数据库URL配置错误 #

spring.datasource.url=:${SPRING_DATASOURCE_URL} 里的前置冒号是多余的，会导致URL格式无效，无法连接数据库。

3. dotenv.path=.env配置无效 #

该配置并非Spring Boot或常用.env解析库的有效配置项，无法引导框架找到.env文件。

修复步骤 #

步骤1：添加.env解析依赖 #

在pom.xml中加入java-dotenv依赖（目前最常用的Java环境变量解析库）：

<dependency>
    <groupId>io.github.cdimascio</groupId>
    <artifactId>java-dotenv</artifactId>
    <version>5.2.2</version> <!-- 可替换为最新稳定版 -->
</dependency>

步骤2：修正application.properties配置 #

修改数据库URL的错误配置，并移除无效的dotenv.path项：

spring.application.name=chatop_FS

# 修正URL的前置冒号问题
spring.datasource.url=${SPRING_DATASOURCE_URL}
spring.datasource.username=${SPRING_DATASOURCE_USERNAME}
spring.datasource.password=${SPRING_DATASOURCE_PASSWORD}

logging.level.root=INFO
logging.level.org.springframework.boot.web.embedded.tomcat=INFO
logging.level.org.springframework=DEBUG
#Tomcat configuration
server.port=5656

spring.mvc.pathmatch.matching-strategy=ant_path_matcher

步骤3：在启动类中手动加载.env文件 #

在Spring Boot启动类中添加代码，加载根目录的.env文件并将变量注入系统环境：

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

@SpringBootApplication
public class ChatopFsApplication {
    public static void main(String[] args) {
        // 加载项目根目录的.env文件
        Dotenv dotenv = Dotenv.load();
        // 将.env中的变量设置为系统环境变量，供Spring读取
        dotenv.entries().forEach(entry -> System.setProperty(entry.getKey(), entry.getValue()));
        
        SpringApplication.run(ChatopFsApplication.class, args);
    }
}

额外检查项 #

• 确保.env文件格式正确：变量名和值之间不要加空格，例如SPRING_DATASOURCE_URL=jdbc:postgresql://localhost:5432/your_db_name，不要加引号。
• 确认已添加PostgreSQL驱动依赖（如果还没加）：

<dependency>
    <groupId>org.postgresql</groupId>
    <artifactId>postgresql</artifactId>
    <scope>runtime</scope>
</dependency>

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