在 Maven 多模块中按模块禁用 build cache 并保留命令行总开关
把 CI 的总开关和扩展读取的 maven.build.cache.enabled 分开。CI 通过自定义参数 ci.cache.enabled 激活 profile,父 POM 的 profile 再把 maven.build.cache.enabled 设为 true;不缓存的模块则在自己的 POM 里写死 maven.build.cache.enabled=false。这样命令行只控制自定义参数,不会让最高优先级的 -Dmaven.build.cache.enabled=... 覆盖模块级排除。
Maven 的 -D 参数属于用户属性,优先级高于 POM 和 profile 里的 properties。CI 如果直接执行 -Dmaven.build.cache.enabled=true,子模块 POM 中同名的 false 都会被覆盖,结果就是全开或全关。换一个参数做全局开关,再由 profile 把最终值写进父 POM,子模块就能用自己的 properties 覆盖继承值。
1. 父 POM:默认关闭,由 CI 参数激活开启
<properties>
<maven.build.cache.enabled>false</maven.build.cache.enabled>
</properties>
<profiles>
<profile>
<id>ci-cache</id>
<activation>
<property>
<name>ci.cache.enabled</name>
<value>true</value>
</property>
</activation>
<properties>
<maven.build.cache.enabled>true</maven.build.cache.enabled>
</properties>
</profile>
</profiles>
2. 不缓存的模块:显式关闭
在对应子模块的 pom.xml 中增加:
<properties>
<maven.build.cache.enabled>false</maven.build.cache.enabled>
</properties>
子模块自身定义的 properties 会覆盖从父 POM 继承的同名值。
3. 使用方式
在 CI 中给大多数模块启用缓存:
mvn -Dci.cache.enabled=true verify
本地构建或整体禁用缓存:
mvn verify
或显式关闭:
mvn -Dci.cache.enabled=false verify
如果只是应急全局关闭,继续用 -Dmaven.build.cache.enabled=false 是安全的;但不要用 -Dmaven.build.cache.enabled=true 做 CI 总开关,否则会覆盖模块级排除。
4. 验证
对不缓存的模块,可以查看生效后的 POM:
mvn -pl 不缓存模块名 -Dci.cache.enabled=true help:effective-pom
确认该模块的 maven.build.cache.enabled 仍为 false。同时检查 .mvn/maven-build-cache-config.xml 中的远程缓存配置是否只通过 profile 或环境变量启用。
注意:不同版本的 maven-build-cache-extension 对配置和属性的支持可能不一样。如果所用版本提供模块级 executionControl 或 skip 配置,可以优先按它的官方 schema 来。上面这套做法依赖 Maven 的属性优先级和父子 POM 覆盖规则,适合需要保留命令行总开关、只排除少数模块的场景。
备注:内容仅供参考。
