作为一个 Java 程序员你一定对下面这些日常敲烂的命令不陌生mvn clean install -Dmaven.test.skiptrue跳过烦人的单元测试mvn spring-boot:run -Dspring.profiles.activedev在本地用 dev 环境跑起来当年初学 Spring Boot 的时候我是把这些命令当成“咒语”死记硬背下来的。我一直以为-D后面的那一长串是 Java 或者是 Spring 框架内置的某种特殊魔法指令。直到最近在重构公司底层的企业级框架抽离统一的platform-build-parent时我被迫脱离了官方spring-boot-starter-parent的庇护去手写那些底层的插件配置。在这个过程中我终于扒开了这层神秘的面纱。原来这一切都是一场美丽的误会。核心真相-D 到底是什么要解开这个谜团我们首先要明白一个核心真相在 Maven 的世界里命令行里的-DxxxyyyD 代表 Define本质上仅仅是在向 Maven 的上下文中注入或覆盖一个全局属性Property。它就像是你往 Maven 这个“大总线”上挂载了一个键值对。至于这个键值对能起什么作用完全取决于有没有哪个底层插件去读取它。这也就引出了本篇博客的核心那层让人迷糊的“三层套娃”关系。第一层Java 虚拟机的系统属性 (JVM System Properties)在最底层的 Java 语言里当你用java命令启动一个程序时可以通过-D参数给 JVM 传递一个全局系统属性java-Dspring.profiles.activedev-jarmy-app.jar这个时候-D是Java 命令自己的语法。它把spring.profiles.active存入了 JVM 内存。Spring Boot 内部的机制会去读取这个 JVM 属性通过System.getProperty从而激活 dev 环境。这是最纯粹的运行时行为。第二层Maven 的全局属性 (Maven Properties)但是我们在本地开发时敲的往往是mvn spring-boot:run-Dspring.profiles.activedev注意这里你调用的是mvn命令而不是java命令此时的-D是Maven 命令的语法。它只是把spring.profiles.activedev变成了一个 Maven 上下文里的普通变量。那 Spring 是怎么读到这个变量的呢这就引出了第三层。第三层中间的“二道贩子”Maven 插件当执行mvn spring-boot:run时真正干活的是spring-boot-maven-plugin这个插件。这个插件为了方便开发者在它的底层实现里做了一个“搬运工”的操作它发现你在 Maven 里传了某个它认识的属性它就会在底层真正去调用java -jar或者 fork 一个新的进程时把你在 Maven 里传的参数原封不动地当作 JVM 参数塞给底层的 Java 进程。这就像是你把信交给了邮递员Maven邮递员帮你把信塞进了信箱JVM最后被收件人Spring读到了。 避坑彩蛋正是因为这种语法上的“撞脸”混淆太严重了Spring Boot 官方后来专门为 Maven 插件引入了一个独立的参数。如果你查阅最新的文档官方现在更推荐用这个命令启动mvn spring-boot:run -Dspring-boot.run.profilesdev你看加了spring-boot.run前缀后这就非常清晰了——它明确表示这是一个传给 Maven 插件的变量而不是直接去碰瓷底层的 JVM 属性。举一反三那些你以为的魔法全都是插件的默认值理解了-D就是在覆盖 Maven 的properties变量我们就能看懂很多底层架构的玩法了。1. 为什么 -Dmaven.test.skiptrue 能跳过测试因为官方的maven-surefire-plugin源码里写了类似这样的注解Parameter(property maven.test.skip, defaultValue false)只要你在命令行一敲插件就会捕捉到并在运行时把自己的变量变成true。2. 怎么自己造“咒语”紧急逃生口设计在企业基座框架中我们通常会引入maven-enforcer-plugin来扫描依赖黑名单比如封杀有漏洞的 log4j 1.x。如果有违规直接打断构建。但在凌晨 2 点紧急发版救火时我们需要一个“逃生口”。我们可以在 Parent 的pom.xml里这样写properties!-- 默认强管控不可跳过 --enforcer.skipfalse/enforcer.skip/propertiesbuildpluginsplugingroupIdorg.apache.maven.plugins/groupIdartifactIdmaven-enforcer-plugin/artifactIdconfiguration!-- 插件读取上面的变量 --skip${enforcer.skip}/skip/configuration/plugin/plugins/build平时大家正常打包受黑名单管控。一旦遇到极其紧急的情况开发同学只需要敲下mvn clean install -Denforcer.skiptrue就能瞬间覆盖默认的false跳过检查完成“带病发版”。这种“外柔内刚”的设计全靠理解了 Maven 变量覆盖的本质。3. 为什么你从没配过启动类打出的 Jar 包却能跑在手写底层框架的 Parent POM 时我还遇到了一个 IDE 疯狂画红线的配置spring-boot.run.main-class${start-class}/spring-boot.run.main-classIDEA 会一直报错说找不到${start-class}。我当时很纳闷我平时写业务代码从来没配过这个东西啊原来这也是spring-boot-maven-plugin替我们负重前行了如果不显式配置插件会在打包时自动扫描所有带有SpringBootApplication注解且包含main方法的类然后自动将它的全限定名动态赋值给${start-class}这个内部变量。在脱离官方 Parent 后我们必须自己写出这行“胶水代码”把插件扫描出来的变量传递给底层的 Jar 插件或者 Shade 插件这才能让打包出来的 Jar 的MANIFEST.MF里写上正确的启动类。为了消除 IDE 的报错红线我们只需在properties里给它声明一个空的默认值start-class/即可。这也再次印证了哪有什么岁月静好不过是插件在替你默默寻找。结语在日常的 CRUD 开发中我们习惯了站在巨人的肩膀上习惯了 Spring Boot 官方 Parent 给我们铺好的康庄大道。但如果你有机会去维护一个脱离官方脚手架的企业级底层框架你会发现平时那些“理所当然”的东西比如不用写RequestParam(id)的id是因为官方开启了parameterstrue/parameters编译参数比如可以直接-D覆盖参数背后其实都是前辈们精心铺设的基础设施。从“熟练使用轮子”到“看懂轮子是怎么转的”也许这就是我们在技术进阶之路上必须跨过的一道坎。
脱离 Spring Boot 官方 Parent 之后，我才弄懂 Maven 的 -D 参数真相
发布时间：2026/5/16 17:32:17
作为一个 Java 程序员你一定对下面这些日常敲烂的命令不陌生mvn clean install -Dmaven.test.skiptrue跳过烦人的单元测试mvn spring-boot:run -Dspring.profiles.activedev在本地用 dev 环境跑起来当年初学 Spring Boot 的时候我是把这些命令当成“咒语”死记硬背下来的。我一直以为-D后面的那一长串是 Java 或者是 Spring 框架内置的某种特殊魔法指令。直到最近在重构公司底层的企业级框架抽离统一的platform-build-parent时我被迫脱离了官方spring-boot-starter-parent的庇护去手写那些底层的插件配置。在这个过程中我终于扒开了这层神秘的面纱。原来这一切都是一场美丽的误会。核心真相-D 到底是什么要解开这个谜团我们首先要明白一个核心真相在 Maven 的世界里命令行里的-DxxxyyyD 代表 Define本质上仅仅是在向 Maven 的上下文中注入或覆盖一个全局属性Property。它就像是你往 Maven 这个“大总线”上挂载了一个键值对。至于这个键值对能起什么作用完全取决于有没有哪个底层插件去读取它。这也就引出了本篇博客的核心那层让人迷糊的“三层套娃”关系。第一层Java 虚拟机的系统属性 (JVM System Properties)在最底层的 Java 语言里当你用java命令启动一个程序时可以通过-D参数给 JVM 传递一个全局系统属性java-Dspring.profiles.activedev-jarmy-app.jar这个时候-D是Java 命令自己的语法。它把spring.profiles.active存入了 JVM 内存。Spring Boot 内部的机制会去读取这个 JVM 属性通过System.getProperty从而激活 dev 环境。这是最纯粹的运行时行为。第二层Maven 的全局属性 (Maven Properties)但是我们在本地开发时敲的往往是mvn spring-boot:run-Dspring.profiles.activedev注意这里你调用的是mvn命令而不是java命令此时的-D是Maven 命令的语法。它只是把spring.profiles.activedev变成了一个 Maven 上下文里的普通变量。那 Spring 是怎么读到这个变量的呢这就引出了第三层。第三层中间的“二道贩子”Maven 插件当执行mvn spring-boot:run时真正干活的是spring-boot-maven-plugin这个插件。这个插件为了方便开发者在它的底层实现里做了一个“搬运工”的操作它发现你在 Maven 里传了某个它认识的属性它就会在底层真正去调用java -jar或者 fork 一个新的进程时把你在 Maven 里传的参数原封不动地当作 JVM 参数塞给底层的 Java 进程。这就像是你把信交给了邮递员Maven邮递员帮你把信塞进了信箱JVM最后被收件人Spring读到了。 避坑彩蛋正是因为这种语法上的“撞脸”混淆太严重了Spring Boot 官方后来专门为 Maven 插件引入了一个独立的参数。如果你查阅最新的文档官方现在更推荐用这个命令启动mvn spring-boot:run -Dspring-boot.run.profilesdev你看加了spring-boot.run前缀后这就非常清晰了——它明确表示这是一个传给 Maven 插件的变量而不是直接去碰瓷底层的 JVM 属性。举一反三那些你以为的魔法全都是插件的默认值理解了-D就是在覆盖 Maven 的properties变量我们就能看懂很多底层架构的玩法了。1. 为什么 -Dmaven.test.skiptrue 能跳过测试因为官方的maven-surefire-plugin源码里写了类似这样的注解Parameter(property maven.test.skip, defaultValue false)只要你在命令行一敲插件就会捕捉到并在运行时把自己的变量变成true。2. 怎么自己造“咒语”紧急逃生口设计在企业基座框架中我们通常会引入maven-enforcer-plugin来扫描依赖黑名单比如封杀有漏洞的 log4j 1.x。如果有违规直接打断构建。但在凌晨 2 点紧急发版救火时我们需要一个“逃生口”。我们可以在 Parent 的pom.xml里这样写properties!-- 默认强管控不可跳过 --enforcer.skipfalse/enforcer.skip/propertiesbuildpluginsplugingroupIdorg.apache.maven.plugins/groupIdartifactIdmaven-enforcer-plugin/artifactIdconfiguration!-- 插件读取上面的变量 --skip${enforcer.skip}/skip/configuration/plugin/plugins/build平时大家正常打包受黑名单管控。一旦遇到极其紧急的情况开发同学只需要敲下mvn clean install -Denforcer.skiptrue就能瞬间覆盖默认的false跳过检查完成“带病发版”。这种“外柔内刚”的设计全靠理解了 Maven 变量覆盖的本质。3. 为什么你从没配过启动类打出的 Jar 包却能跑在手写底层框架的 Parent POM 时我还遇到了一个 IDE 疯狂画红线的配置spring-boot.run.main-class${start-class}/spring-boot.run.main-classIDEA 会一直报错说找不到${start-class}。我当时很纳闷我平时写业务代码从来没配过这个东西啊原来这也是spring-boot-maven-plugin替我们负重前行了如果不显式配置插件会在打包时自动扫描所有带有SpringBootApplication注解且包含main方法的类然后自动将它的全限定名动态赋值给${start-class}这个内部变量。在脱离官方 Parent 后我们必须自己写出这行“胶水代码”把插件扫描出来的变量传递给底层的 Jar 插件或者 Shade 插件这才能让打包出来的 Jar 的MANIFEST.MF里写上正确的启动类。为了消除 IDE 的报错红线我们只需在properties里给它声明一个空的默认值start-class/即可。这也再次印证了哪有什么岁月静好不过是插件在替你默默寻找。结语在日常的 CRUD 开发中我们习惯了站在巨人的肩膀上习惯了 Spring Boot 官方 Parent 给我们铺好的康庄大道。但如果你有机会去维护一个脱离官方脚手架的企业级底层框架你会发现平时那些“理所当然”的东西比如不用写RequestParam(id)的id是因为官方开启了parameterstrue/parameters编译参数比如可以直接-D覆盖参数背后其实都是前辈们精心铺设的基础设施。从“熟练使用轮子”到“看懂轮子是怎么转的”也许这就是我们在技术进阶之路上必须跨过的一道坎。
