如何在Spring Boot与Docker Compose中为Application.properties动态赋值？

一、Spring Boot 配置文件改造（占位符方式） #

首先把固定配置改成环境变量占位符，支持默认值兜底，这样就能通过外部传入值覆盖默认配置。

1. application.properties 改造 #

# application.properties
spring.datasource.url=jdbc:postgresql://postgres:5432/${DB_NAME:test}
spring.datasource.username=${DB_USERNAME:admin}
spring.datasource.password=${DB_PASSWORD:admin}
spring.jpa.database=POSTGRESQL

格式说明：${变量名:默认值}，如果外部没传变量，就用冒号后的默认值；传了则直接替换。

2. application-dev.properties 改造 #

dev环境配置逻辑完全一致，可单独定义dev专属变量（也可复用变量，按需选择）：

# application-dev.properties
spring.datasource.url=jdbc:postgresql://postgres-dev:5432/${DB_DEV_NAME:test-dev}
spring.datasource.username=${DB_DEV_USERNAME:dev-admin}
spring.datasource.password=${DB_DEV_PASSWORD:dev-admin}
spring.jpa.database=POSTGRESQL

二、Docker Compose 传递动态参数 #

通过Docker Compose可以两种方式传入变量，确保Spring Boot和PostgreSQL的配置一致。

方式1：docker-compose.yml 直接指定环境变量 #

version: '3.8'
services:
  postgres:
    image: postgres:15
    environment:
      # Postgres初始化用的环境变量，和Spring变量对应
      POSTGRES_DB: ${DB_NAME:test}
      POSTGRES_USER: ${DB_USERNAME:admin}
      POSTGRES_PASSWORD: ${DB_PASSWORD:admin}
    ports:
      - "5432:5432"
  spring-app:
    build: .
    environment:
      - DB_NAME=${DB_NAME:test}
      - DB_USERNAME=${DB_USERNAME:admin}
      - DB_PASSWORD=${DB_PASSWORD:admin}
      # 启用dev环境时添加该行
      # - SPRING_PROFILES_ACTIVE=dev
    ports:
      - "8080:8080"
    depends_on:
      - postgres

方式2：用 .env 文件统一管理变量 #

创建 .env 文件存所有动态参数：

DB_NAME=my-custom-db
DB_USERNAME=my-user
DB_PASSWORD=my-secure-pass
# dev环境变量（启用时添加）
# DB_DEV_NAME=my-dev-db
# DB_DEV_USERNAME=dev-user
# DB_DEV_PASSWORD=dev-pass

然后修改docker-compose.yml自动读取.env变量：

version: '3.8'
services:
  postgres:
    image: postgres:15
    environment:
      POSTGRES_DB: ${DB_NAME}
      POSTGRES_USER: ${DB_USERNAME}
      POSTGRES_PASSWORD: ${DB_PASSWORD}
    ports:
      - "5432:5432"
  spring-app:
    build: .
    environment:
      - DB_NAME=${DB_NAME}
      - DB_USERNAME=${DB_USERNAME}
      - DB_PASSWORD=${DB_PASSWORD}
      # 启用dev环境
      # - SPRING_PROFILES_ACTIVE=dev
      # - DB_DEV_NAME=${DB_DEV_NAME}
      # - DB_DEV_USERNAME=${DB_DEV_USERNAME}
      # - DB_DEV_PASSWORD=${DB_DEV_PASSWORD}
    ports:
      - "8080:8080"
    depends_on:
      - postgres

方式3：启动时临时传入参数 #

不需要修改配置文件，启动时直接在命令行传变量覆盖：

DB_NAME=new-test DB_USERNAME=new-admin DB_PASSWORD=new-pass docker-compose up -d

三、前端触发动态配置（运行时调整） #

如果需要前端触发修改数据库配置，得结合Spring Boot的配置刷新机制，最简单的方案是用@RefreshScope配合Spring Cloud Config（或自定义接口实现）：

1. 核心代码示例 #

import org.springframework.cloud.context.config.annotation.RefreshScope;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.*;
import javax.sql.DataSource;
import java.sql.Connection;
import java.sql.SQLException;

@RefreshScope
@RestController
public class DbConfigController {

    private final DataSource dataSource;
    @Value("${spring.datasource.username}")
    private String dbUsername;
    @Value("${spring.datasource.url}")
    private String dbUrl;

    public DbConfigController(DataSource dataSource) {
        this.dataSource = dataSource;
    }

    // 测试当前数据库连接状态
    @GetMapping("/db/check")
    public String checkDbConnection() {
        try (Connection conn = dataSource.getConnection()) {
            return "连接成功，当前数据库：" + conn.getCatalog();
        } catch (SQLException e) {
            return "连接失败：" + e.getMessage();
        }
    }

    // 触发配置更新（需结合配置中心实现实时生效）
    @PostMapping("/db/update-config")
    public String updateDbConfig(@RequestParam String username, @RequestParam String password, @RequestParam String dbName) {
        // 实际场景中，这里应该把配置写入外部配置源（如Git/配置中心）
        // 写入后调用刷新接口：POST /actuator/refresh
        return "配置已提交，调用 /actuator/refresh 生效";
    }
}

2. 生效说明 #

• 需要引入Spring Boot Actuator依赖，开启刷新端点
• 前端调用更新接口后，再调用/actuator/refresh触发配置重新加载，无需重启应用

四、application-dev.properties 启用与配置 #

要切换到dev环境，只需在启动时指定SPRING_PROFILES_ACTIVE=dev：

• 在docker-compose.yml的spring-app服务环境变量中添加：- SPRING_PROFILES_ACTIVE=dev
• 同时传入dev专属的数据库变量（如DB_DEV_NAME等），即可自动加载application-dev.properties并替换占位符

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