Maven Build Cache Extension无法恢复/target目录构建产物问题

核心原因：输出缓存规则缺失 #

你的配置仅定义了输入缓存规则（哪些文件变更会触发缓存失效），但未明确输出缓存规则（哪些产物需要被缓存和恢复）。官方默认输出规则在多模块（EAR/WAR/JAR混合）场景下可能未覆盖全部主产物的恢复逻辑，导致日志显示触发恢复，但target目录下的核心产物未被放回。另外，日志仅显示com.xxx:yyy模块的恢复状态，未提及其他子模块（aaa/bbb/ccc），不排除这些子模块的缓存未被正确命中。

具体解决方案 #

1. 补充输出缓存配置 #

在maven-build-cache-config.xml中新增<output>节点，明确指定要缓存的产物范围：

<cache xmlns="http://maven.apache.org/BUILD-CACHE-CONFIG/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://maven.apache.org/BUILD-CACHE-CONFIG/1.0.0 https://maven.apache.org/xsd/build-cache-config-1.0.0.xsd">

    <!-- 保留原有configuration和input节点 -->
    <configuration>...</configuration>
    <input>...</input>

    <!-- 新增输出缓存规则 -->
    <output>
        <global>
            <includes>
                <!-- 缓存target目录下所有文件，包含主产物与临时构建文件 -->
                <include>target/**/*</include>
            </includes>
        </global>
    </output>
</cache>

2. 验证全模块缓存命中状态 #

重新执行mvn clean package，查看完整日志确认所有子模块（aaa/bbb/ccc）均触发缓存恢复。若部分模块未命中，检查：

• 子模块pom.xml是否自定义了输出目录
• 输入规则是否覆盖了src/以外的变更源（如根目录下的配置文件）

3. 检查缓存存储目录 #

默认缓存存储在~/.mvn/build-cache，进入对应模块的缓存目录，确认是否存在target相关的缓存文件。若缓存为空，先执行一次mvn package（不带clean）生成完整缓存。

4. 升级扩展版本 #

maven-build-cache-extension 1.1.0存在多模块场景下的产物恢复bug，建议升级至最新稳定版（如1.2.0），修改extensions.xml：

<extension>
    <groupId>org.apache.maven.extensions</groupId>
    <artifactId>maven-build-cache-extension</artifactId>
    <version>1.2.0</version>
</extension>

内容的提问来源于stack exchange，提问作者Bossk