技术问询：Maven Jacoco插件prepare-agent目标被重复添加

我之前也碰到过类似的情况，结合你使用的Maven 3.2和Jacoco 0.5.5版本，以及给出的pom配置，下面是几个针对性的解决方案：

1. 检查父POM的继承配置 #

这种重复添加的问题最常见的原因是当前项目继承的父POM已经配置了Jacoco插件，而你在当前pom里又重复配置了一遍，导致prepare-agent目标被多次绑定到生命周期。

• 如果父POM的Jacoco配置是必须保留的，你可以在当前pom的插件配置里添加<inherited>false</inherited>，禁用插件的继承：

<plugin>
  <groupId>org.jacoco</groupId>
  <artifactId>jacoco-maven-plugin</artifactId>
  <version>0.5.5.201112152213</version>
  <inherited>false</inherited> <!-- 禁用继承 -->
  <configuration>
    <destFile>${basedir}/target/reports/jacoco.exec</destFile>
    <dataFile>${basedir}/target/reports/jacoco.exec</dataFile>
  </configuration>
  <!-- 你的executions配置 -->
</plugin>

• 如果父POM的Jacoco配置对你的项目没用，直接移除当前pom里的重复Jacoco配置即可。

2. 规范插件的生命周期绑定 #

确保你只在一个地方将prepare-agent目标绑定到Maven生命周期阶段，并且给每个execution设置唯一的ID，避免Maven识别为重复目标。完整的配置示例如下：

<build>
  <plugins>
    <plugin>
      <groupId>org.jacoco</groupId>
      <artifactId>jacoco-maven-plugin</artifactId>
      <version>0.5.5.201112152213</version>
      <configuration>
        <destFile>${basedir}/target/reports/jacoco.exec</destFile>
        <dataFile>${basedir}/target/reports/jacoco.exec</dataFile>
      </configuration>
      <executions>
        <!-- 唯一ID的prepare-agent执行 -->
        <execution>
          <id>jacoco-prepare-agent-unique</id>
          <goals>
            <goal>prepare-agent</goal>
          </goals>
          <phase>initialize</phase> <!-- 绑定到单个生命周期阶段 -->
        </execution>
        <!-- 可选的report执行，按需添加 -->
        <execution>
          <id>jacoco-generate-report</id>
          <goals>
            <goal>report</goal>
          </goals>
          <phase>test</phase>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

3. 排查插件的间接依赖 #

有些第三方插件可能会间接引入Jacoco的配置，导致重复绑定。你可以执行以下Maven命令查看Jacoco插件的所有绑定详情：

mvn help:describe -Dplugin=jacoco -Ddetail

从输出里找有没有重复的prepare-agent目标绑定，定位来源后再调整配置。

4. 清理Maven缓存并升级插件（推荐） #

你使用的Jacoco版本是2011年的老旧版本，存在很多已知bug，包括可能导致重复绑定的问题。建议：

1. 先清理Maven本地缓存，执行：

mvn clean install -U

2. 升级Jacoco插件到较新的稳定版本（比如0.8.10），新版本不仅修复了旧bug，还兼容更高版本的Maven和JDK，配置方式基本一致，只需要修改<version>字段即可。

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