本文详解如何通过 spring profiles + 外部化配置 + maven profile 协同实现开发、测试、生产环境的无缝切换，支持本地运行测试与 docker 部署共用同一套配置逻辑，避免硬编码、重复维护和环境不一致问题。

本文详解如何通过 spring profiles + 外部化配置 + maven profile 协同实现开发、测试、生产环境的无缝切换，支持本地运行测试与 docker 部署共用同一套配置逻辑，避免硬编码、重复维护和环境不一致问题。

在 Spring Boot 项目中，面对数十个环境敏感配置（如 spring.datasource.url、spring.redis.host、logging.file.path 等），若依赖多套 application-*.properties 文件并手动切换，极易引发配置遗漏、测试失败或容器启动异常。核心矛盾在于：本地单元/集成测试需可执行的默认值，而 Docker 容器又需从环境变量动态注入真实生产参数。幸运的是，Spring Boot 原生提供了优雅解法——无需插件、无需复杂构建脚本，仅靠标准机制即可统一治理。

✅ 推荐架构：三层配置优先级 + Profile 驱动

遵循 Spring Boot Externalized Configuration 规范，采用以下分层策略（由高到低优先级）：

1. 系统环境变量（如 DATASOURCE=jdbc:mysql://prod-db:3306/app）→ Docker 容器内生效
2. application-{profile}.properties（如 application-container.properties）→ 定义占位符与 Profile 特有逻辑
3. application.properties（主配置） → 统一激活 Profile 并声明占位符默认值（保障本地测试可用）

✅ 关键原则：所有敏感属性均使用 ${...} 占位符，绝不写死值；默认值仅用于本地开发/测试兜底，生产环境必须由外部注入。

▪ 步骤 1：精简配置文件结构（推荐标准布局）

src/main/resources/
├── application.properties              ← 主入口：激活 profile + 设默认值
├── application-dev.properties        ← 开发专用（可选，用于 IDE 快速调试）
└── application-container.properties    ← 容器专用：纯占位符，无默认值

application.properties

# 激活 profile —— 由 Maven 或 JVM 参数控制
spring.profiles.active=${APP_PROFILE:dev}

# 兜底默认值（仅用于本地 mvn test / IDE 运行，Docker 中会被环境变量覆盖）
spring.datasource.url=${DATASOURCE:jdbc:h2:mem:testdb;DB_CLOSE_DELAY=-1}
spring.datasource.username=${DB_USER:sa}
spring.datasource.password=${DB_PASS:}
spring.redis.host=${REDIS_HOST:localhost}
spring.redis.port=${REDIS_PORT:6379}
logging.file.path=${LOG_PATH:./logs}

application-container.properties（轻量、无默认值）

# 显式声明此 profile 下所有配置均来自环境变量
# （即使 application.properties 已设默认值，此处也确保容器中强制使用 env）
spring.datasource.url=${DATASOURCE}
spring.datasource.username=${DB_USER}
spring.datasource.password=${DB_PASS}
spring.redis.host=${REDIS_HOST}
spring.redis.port=${REDIS_PORT}
logging.file.path=${LOG_PATH}

? 注意：application-container.properties 不需要任何默认值，它的唯一作用是显式声明“该 Profile 下所有配置必须外部提供”，避免因 application.properties 的兜底值导致生产环境误用测试数据库。

▪ 步骤 2：Maven Profile 控制构建时行为（非运行时！）

Maven Profile 仅用于构建阶段差异化处理（如跳过测试、指定资源过滤），而非运行时激活 Spring Profile。因此，应移除 <spring.profiles.active></spring.profiles.active> 在 Maven 层的冗余设置（它属于运行时范畴）：

pom.xml 中正确配置示例：

docker-container-rerun-all

顺序检查并可选更新所有已在长期记忆中记录了固定重建命令的 docker run 容器。使用场景：用户...

下载

<profiles><profile><id>dev</id><activation><activebydefault>true</activebydefault></activation><properties><activatedprofile>dev</activatedprofile><!-- 仅用于资源过滤标识，不影响 Spring --></properties></profile><profile><id>container</id><properties><activatedprofile>container</activatedprofile></properties></profile></profiles><build><resources><!-- 构建时将对应 profile 的配置复制为最终 application.properties --><resource><directory>src/main/resources</directory><filtering>true</filtering><includes><include>application.properties</include><include>application-${activatedProfile}.properties</include></includes></resource></resources></build>

✅ 构建命令示例：

• 本地开发打包（含测试）：mvn clean package -Pdev
• 生产镜像构建（跳过测试）：mvn clean package -Pcontainer -DskipTests

▪ 步骤 3：Docker 部署时精准激活 Profile + 注入环境变量

Dockerfile（推荐 multi-stage，精简镜像）

# 构建阶段
FROM maven:3.8-openjdk-17-slim AS builder
WORKDIR /app
COPY pom.xml .
COPY src ./src
RUN mvn clean package -Pcontainer -DskipTests

# 运行阶段（基于 lean JRE）
FROM openjdk:17-jre-slim
VOLUME ["/app/logs"]
EXPOSE 8080
ARG JAR_FILE=target/*.jar
COPY --from=builder /app/${JAR_FILE} app.jar
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]

docker-compose.yml（关键：环境变量 + Spring Profile）

version: '3.8'
services:
  app:
    build: .
    image: my-spring-app:latest
    environment:
      - SPRING_PROFILES_ACTIVE=container  # ← 激活 container profile
      - DATASOURCE=jdbc:mysql://mysql8:3306/proddb?useSSL=false
      - DB_USER=prod_user
      - DB_PASS=prod_secret
      - REDIS_HOST=redis
      - LOG_PATH=/app/logs
    env_file:
      - ./docker.env  # ← 可选：集中管理所有 env 变量
    depends_on:
      - mysql8
      - redis

✅ 此时 SPRING_PROFILES_ACTIVE=container 会触发加载 application-container.properties，其中所有 ${...} 占位符自动从 environment 或 env_file 中读取，零配置修改即可切换环境。

▪ 步骤 4：本地测试保障（无需 Docker！）

• 单元测试（JUnit）：Spring Boot Test 自动使用 @ActiveProfiles("dev") 或默认 dev，读取 application-dev.properties 或 application.properties 中的兜底值（如 H2 内存库），秒级启动。
• 集成测试（需真实 DB/Redis）：

  # 临时覆盖环境变量运行测试
  DATASOURCE=jdbc:h2:mem:testdb DB_USER=sa mvn verify -Pcontainer

  或在 src/test/resources/application-test.properties 中定义测试专用值。

⚠️ 重要注意事项

• 禁止在 application.properties 中写死生产地址（如 localhost:3306），这是安全红线；
• Docker 中永远不要挂载 application.properties 覆盖整个文件，应只通过环境变量注入，保持镜像不可变性；
• 若使用 dockerfile-maven-plugin，请确保其 buildArgs 正确传递 APP_PROFILE，但更推荐上述纯 Dockerfile 方式，解耦清晰；
• 对于 20+ 参数，建议将 docker.env 文件纳入 Git（脱敏后），用 CI/CD 流水线注入密钥（如 Vault）；
• 日志路径、上传目录等路径务必使用 Linux 格式（/app/logs），避免 Windows 路径（C:\logs）导致容器内权限错误。

✅ 总结：一套配置，三重保障

场景	激活 Profile	配置来源	目的
本地开发	dev（默认）	application.properties兜底值	快速启动，免依赖
本地集成测试	container	环境变量（CLI 或 .env）	验证真实配置兼容性
Docker 部署	container	docker-compose.yml / env_file	生产就绪，安全可控

这种设计彻底解耦了构建、测试与部署流程，让团队聚焦业务逻辑，而非疲于配置运维。一次编写，处处可靠——这正是 Spring Boot 与 Docker 协同演进的最佳实践。