PAYATHON 2026

在 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 覆盖规则,适合需要保留命令行总开关、只排除少数模块的场景。

备注:内容仅供参考。