为什么把 Profile 写在父模块#

• 多模块下每个子模块都依赖 parent，配置天然继承
• 切换环境只需控制父模块 profile，CI/CD 更好统一
• 对团队协作友好：大家不需要各自维护一份“本地 dev 配置”

使用方式（命令）#

1
# dev 打包
2
mvn -Pdev clean package
3

4
# prod 打包
5
mvn -Pprod clean package

在 IDE（例如 IntelliJ IDEA）里，也可以在 Maven 面板里勾选对应 profile，然后运行子模块的启动类即可（前提是子模块启用了资源过滤，后面会讲）。

1）子模块开启资源过滤（resource filtering）#

在子模块（或统一放在父模块的 <build><pluginManagement> 里让子模块继承）配置 resources 过滤。

以子模块 pom.xml 为例（关键段落）：

1
<build>
2
  <resources>
3
    <resource>
4
      <directory>src/main/resources</directory>
5
      <filtering>true</filtering>
6
    </resource>
7
  </resources>
8
</build>

这样 Maven 在 process-resources 阶段会对 src/main/resources 下的文件做占位符替换。

2）在 application.yml 里引用父模块 Profile 变量#

在子模块 src/main/resources/application.yml 里写：

1
spring:
2
  profiles:
3
    active: "@profile.active@"
4

5
app:
6
  config-server-url: "@config.server.url@"

这里用的是 Maven 的 @...@ 占位符格式（它比 ${...} 在 YAML 中更不容易和 Spring 本身的占位符混淆）。

当你执行：

1
mvn -Pprod clean package

打包后的 target/classes/application.yml 会变成：

1
spring:
2
  profiles:
3
    active: "prod"
4

5
app:
6
  config-server-url: "http://prod-config:8888"

3）配合多套配置文件：application-{profile}.yml#

建议把“环境差异”尽量放到 application-dev.yml / application-prod.yml 中，让 application.yml 只负责“选择环境”与公共配置。

结构示例：

1
src/main/resources/
2
  application.yml
3
  application-dev.yml
4
  application-test.yml
5
  application-prod.yml

application.yml（只写公共 + 激活环境）：

1
spring:
2
  profiles:
3
    active: "@profile.active@"
4

5
server:
6
  port: 8080

application-dev.yml（写 dev 差异）：

1
spring:
2
  datasource:
3
    url: jdbc:mysql://127.0.0.1:3306/app_dev

application-prod.yml（写 prod 差异）：

1
spring:
2
  datasource:
3
    url: jdbc:mysql://prod-db:3306/app_prod

这样一来：父模块 Maven Profile 决定 spring.profiles.active，SpringBoot 再根据 active profile 自动加载对应的 application-{profile}.yml。

1）本地直接运行为什么不生效#

@profile.active@ 只会在 Maven 资源处理 时被替换。

如果你直接用 IDE “运行启动类”，但没有触发 Maven 的 process-resources，就会出现占位符未替换的情况。

推荐做法：

• 在 IDE 使用 Maven Profile，并确保运行前执行了 process-resources（常见方式是先 mvn -Pdev -DskipTests package 一次）
• 或者在 Run Configuration 里临时加 -Dspring.profiles.active=dev（但这会绕过“父模块统一管理”，不建议作为团队默认方案）

2）过滤导致 application.yml 被破坏#

如果你在 application.yml 里本身也使用 ${...}（比如 Spring 的占位符），Maven 过滤可能会误处理。

建议：

• 用 @...@ 作为 Maven 注入占位符
• Spring 自己的占位符继续用 ${...}，避免混用

3）CI/CD 建议#

CI 里只需要：

1
mvn -Pprod clean package -DskipTests

产物里 profile 已经写死为 prod，运行时不需要额外设置。

如果你希望“同一包多环境运行”，那就不要在构建期写死 spring.profiles.active，改为运行期用环境变量/启动参数控制（这是另一条路线，和本文目标不同）。