为什么 maven-site-plugin 总是使用 3.3 版？

Question

我遇到了maven-site plugins 3.3 java.lang.ClassNotFoundException: org.apache.maven.doxia.siterenderer.DocumentContent中描述的同样问题

我正在尝试设置 maven-site-plugin（至 3.7.1）和 maven-project-info-reports-plugin-version（至 3.0.0）的版本，如答案之一所述。我正在使用 Eclipse，因此我查看了我正在处理的 pom 文件的“有效 POM”选项卡，并且可以看到这些插件的版本是 3.7.1 和 3.0.0，正如我指定的那样。

但是，当我运行 mvn help:effective-pom 时，输出显示 maven-site-plugin 两次 - 我想要的版本是 3.7.1，另一个是 3.3 版本。当我运行 mvn site 时，输出显示它正在使用 maven-site-plugin 3.3。

所以我的问题是，对 maven-site-plugin 版本 3.3 的引用来自哪里，我该如何强制它使用 3.7.1？我已经在 pom 文件中指定了它，但它仍然使用 3.3 版。

这是我对 maven-site-plugin 的定义：

    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-site-plugin</artifactId>
        <version>3.7.1</version>
    </plugin>

顺便说一句，这是一个父 pom 文件，但它是我必须在其中引用 maven-site-plugin 或任何子 pom 文件的唯一参考。

我使用的是 maven 3.2.1 版。

Answer 1

Maven 并不总是使用 maven-site-plugin 3.3 版。

事实上，site 生命周期中使用的插件版本是在 Apache Maven 项目本身的maven-core/src/main/resources/META-INF/plexus/components.xml 中指定的：

<default-phases>
  <site>
    org.apache.maven.plugins:maven-site-plugin:3.3:site
  </site>
  <site-deploy>
    org.apache.maven.plugins:maven-site-plugin:3.3:deploy
  </site-deploy>
</default-phases>

在 maven 3.1.0 之前

version 3.2

自 maven 3.1.0

version 3.3

请参阅此commit 了解更多信息。

自 maven 4.0.0

version 3.9.1

在MNG-7263之后，插件版本在SiteLifecycleProvider.java中指定：

phases.put( "site", new LifecyclePhase( "org.apache.maven.plugins:maven-site-plugin:3.9.1:site" ) );
phases.put( "site-deploy", new LifecyclePhase( "org.apache.maven.plugins:maven-site-plugin:3.9.1:deploy" ) );

问题修复

要覆盖 ma​​ven-site-plugin 版本，请将其添加到 POM 文件的 build 部分，并将 maven-project-info-reports-plugin 添加到 reporting。这是一个完整的工作示例：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>com.mycompany</groupId>
  <artifactId>mavenproject</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>jar</packaging>
  <url>http://www.your.site.com/</url>

  <properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>

  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-site-plugin</artifactId>
        <version>3.7.1</version>
      </plugin>
    </plugins>
  </build>

  <reporting>
    <plugins>
      <plugin>
        <artifactId>maven-project-info-reports-plugin</artifactId>
        <version>3.0.0</version>
      </plugin>
    </plugins>
  </reporting>

</project>

然后生成项目站点：

$ mvn site 

[INFO] Scanning for projects...
[INFO] 
[INFO] ---------------------< com.mycompany:mavenproject >---------------------
[INFO] Building mavenproject 1.0-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO] 
[INFO] --- maven-site-plugin:3.7.1:site (default-site) @ mavenproject ---
[INFO] configuring report plugin org.apache.maven.plugins:maven-project-info-reports-plugin:3.0.0
[INFO] 15 reports detected for maven-project-info-reports-plugin:3.0.0: ci-management, dependencies, dependency-info, dependency-management, distribution-management, index, issue-management, licenses, mailing-lists, modules, plugin-management, plugins, scm, summary, team
...