Spring Boot多模块Maven项目命令行指定Profile不生效问题

问题现象 #

Spring Boot 2.7.0多模块项目，Maven版本3.8.4，项目结构如下：

├───app
│   ├── pom.xml
│   └───src
│       └───main
│           └───java
│               └───com
│                   └───rb
│                       └─── App.java
├───controller
│   ├── pom.xml
│   └───src
│       └───main
│           └───java
│               └───com
│                   └───rb
│                       └─── MainController.java
└ pom.xml

执行如下命令尝试通过快捷写法指定启动profile为local：

mvn clean install; 
mvn spring-boot:run '-Dspring-boot.run.profiles=local' --projects app

应用可以正常启动，但始终激活default默认profile，快捷写法不生效。而通过jvmArguments传参的长写法可以正常激活local profile：

mvn clean install;
mvn spring-boot:run '-Dspring-boot.run.jvmArguments="-Dspring.profiles.active=local"' --projects app

在PowerShell、CMD环境下测试结果一致，去掉参数单引号也无法解决问题。

根因分析 #

问题由两个机制共同导致：

• Maven命令行解析有严格的顺序要求：所有-D开头的系统属性、--projects这类配置选项，按照规范必须放在goal（如spring-boot:run）、生命周期阶段（如install）之前。如果把-D参数写在goal后面，属于未定义的解析行为：单模块项目可能碰巧正常读取参数，但多模块反应堆构建时，这类后置的-D参数只会被注入到根项目/最先构建的模块的属性上下文，不会传递到--projects指定的子模块中。最终app子模块的Spring Boot插件读不到spring-boot.run.profiles的配置值，自然无法激活指定profile，回退到default。
• 长写法-Dspring-boot.run.jvmArguments之所以能生效，是因为该参数最终会被插件用来构造新JVM进程的启动命令，读取的是Maven全局会话层面的属性，刚好没有被参数位置问题影响。

修复方案 #

任选以下一种方案调整即可让快捷写法正常工作：

方案1：调整命令参数顺序（零代码修改，推荐） #

把所有-D参数移到spring-boot:run目标之前，去掉不必要的引号（PowerShell、CMD下无空格、无特殊字符的参数不需要额外包裹引号，多余引号反而可能导致参数解析错误），修改后命令如下：

mvn clean install
mvn -Dspring-boot.run.profiles=local spring-boot:run --projects app

执行后即可正常激活local profile。

方案2：在启动子模块显式声明Spring Boot插件 #

如果不想调整参数书写习惯，可以在app子模块的pom.xml中，把spring-boot-maven-plugin显式声明到<build><plugins>节点下，不要仅在父pom的<pluginManagement>中管理插件。配置后子模块执行插件目标时会优先读取当前模块的属性上下文，即使-D参数放在goal后面也能被正确识别，配置示例如下：

<!-- app模块pom.xml内 -->
<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

补充说明 #

spring-boot:run如果不开启fork模式，会和Maven共享同一个JVM进程，此时spring-boot.run.jvmArguments配置本身是不生效的（JVM启动后无法修改启动参数），之前长写法能生效，说明当前插件配置默认开启了fork模式，不需要额外调整。

内容的提问来源于stack exchange，提问作者Richard Beneš