maven profile 的核心作用是条件化激活构建配置，本质是通过资源过滤+占位符替换实现多环境变量注入；未配置 filtering=true 则 profile 仅在 pom.xml 中生效。

什么是 Maven Profile 的核心作用 Maven Profile 不是“多环境配置”的银弹，它本质是条件化激活一组构建配置（比如 properties、resources 过滤、plugin 行为）。真正起作用的是它配合资源过滤 + 占位符替换，把不同环境的值注入到配置文件里。没做资源过滤，Profile 再多也只在 pom.xml 里自嗨。

关键点：Profile 本身不改代码或配置内容，它只是开关——开哪个，就用哪组变量去替换 ${xxx} 占位符。

如何正确启用 profile 并触发资源过滤 常见错误是只在 pom.xml 里定义了 <profile></profile>，但没配 <resources></resources> 过滤，导致 application.properties 里的 ${env.url} 原样保留，运行时报错或连错地址。

必须同时满足三点：

• 在 <build></build> 下声明 <resources></resources>，并开启 filtering=true
• 把含占位符的配置文件（如 src/main/resources/application.properties）放在 <resources></resources> 路径下
• 用 -Pdev 或 -Pprod 显式激活 profile（默认 activeByDefault=true 很容易被忽略或覆盖）

示例片段：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

<build><resources><resource><directory>src/main/resources</directory><filtering>true</filtering></resource></resources></build>

怎么避免 application.yml 中 ${} 占位符被 Spring Boot 和 Maven 双重解析出错 Spring Boot 默认会解析 ${xxx}，Maven 也会在资源过滤阶段解析一次。如果两个都开，要么报 Could not resolve placeholder，要么解析成空字符串。

解决办法只有两个：

• 对 Maven 过滤用的占位符，统一改成 @xxx@ 格式（需在 pom.xml 中设置 <delimiters><delimiter>@</delimiter></delimiters>），Spring Boot 默认不碰 @xxx@
• 或者关掉 Spring Boot 的占位符解析：spring.config.use-legacy-processing=true（仅限旧版），更推荐前者

别信“加双美元” $${xxx} —— Maven 3.5+ 已弃用该写法，且不可靠。

为什么 -Ptest 启动后还是 dev 配置？检查这三处 Profile 激活失败往往不是语法错，而是被更高优先级配置覆盖：

• settings.xml 里有同名 profile 且 activeByDefault=true，会静默覆盖项目级 profile
• pom.xml 中多个 profile 的 <id></id> 写重复了，后加载的覆盖前一个
• IDE（如 IntelliJ）未将 Maven 命令参数同步到 Run Configuration，实际执行的是无 -P 的 clean package

验证是否生效最直接的方式：在构建后打开 target/classes/application.properties，看占位符是否已被替换成真实值。没变，说明过滤根本没走。

Profile 的复杂性不在定义，而在激活链路和过滤时机。只要确保资源过滤开启、占位符格式不冲突、激活方式被真实传递，剩下的就是变量名对得上——这点反而最容易被手抖写错。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南