Spring Boot 3配置PostgreSQL时环境变量读取失败求助

核心问题：你的Spring Boot服务未成功读取环境变量，导致配置文件中的${POSTGRES_*}占位符未被替换，直接以原始字符串传递给JDBC驱动，触发报错。以下是具体原因和解决办法：

原因1：Spring Boot默认不自动加载根目录.env文件 #

Spring Boot本身不会主动读取项目根目录的.env文件，需手动配置加载规则：

• 在application.yml中添加配置，让Spring Boot识别并加载.env文件：

  spring:
    config:
      import: optional:file:.env[.properties]
  

  （optional:表示如果文件不存在也不会报错，适合开发环境）

原因2：Docker Compose仅给PostgreSQL容器传参，未传递给Spring Boot服务 #

你的docker-compose.yml只定义了PostgreSQL服务，没有将环境变量传递给Spring Boot服务。如果Spring Boot通过Docker运行，需补充服务配置：

version: '3.8'

services:
  postgres:
    image: postgres:latest
    container_name: postgress_db
    restart: always
    environment:
      POSTGRES_DB: ${POSTGRES_DB}
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data

  spring-app:
    build: . # 假设项目根目录有Dockerfile
    container_name: spring-boot-app
    restart: always
    environment:
      POSTGRES_HOST: postgres # 容器间通信直接用服务名，无需localhost
      POSTGRES_PORT: 5432
      POSTGRES_DB: ${POSTGRES_DB}
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    ports:
      - "8080:8080"
    depends_on:
      - postgres

volumes:
  postgres_data:

原因3：本地运行时环境变量未注入JVM进程 #

如果是本地直接启动Spring Boot（IDE或命令行），.env变量不会自动进入JVM环境：

• 命令行启动前先导出变量：

  export POSTGRES_HOST=localhost
  export POSTGRES_PORT=5432
  export POSTGRES_DB=abc-shop
  export POSTGRES_USER=postgres
  export POSTGRES_PASSWORD=postgres
  ./mvnw spring-boot:run
  

• IDEA中，在Run Configuration的「Environment variables」栏直接添加.env中的键值对。

验证环境变量是否读取成功 #

可以添加一个测试接口确认变量是否加载：

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import java.util.Map;

@RestController
public class EnvCheckController {
    @GetMapping("/env-check")
    public Map<String, String> getEnvVars() {
        return System.getenv();
    }
}

访问/env-check接口，检查是否存在POSTGRES_*开头的变量，以此确认加载是否成功。

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