JavaDoc 与 Maven 生成“获取链接时出错：”

Question

使用 Maven 生成 JavaDoc 我收到一条错误消息“获取链接时出错：”引用文件 javadoc-bundle-options。其中包含带有目录的 javadocResourcesDirectory。即使我创建了该目录，我仍然遇到相同的错误。我该如何纠正错误？

    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>3.2.0</version>
    <configuration>
        <show>public</show>
        <quiet>true</quiet>
        <doctitle>${project.name}</doctitle>
        <sourceFileExcludes>**/tests/**/*.java</sourceFileExcludes>
        <links>
            <link>https://docs.oracle.com/en/java/javase/14/docs/api/</link>
        </links>
        <javadocDirectory>javadoc/resources</javadocDirectory>
   </configuration>
    <executions>
        <execution>
            <id>javadocs-jar</id>
            <phase>package</phase>
            <goals>
                <goal>jar</goal>
            </goals>
        </execution>
    </executions>
</plugin>

    <?xml version="1.0" encoding="UTF-8"?>
<javadocOptions>
  <docletArtifacts>
    <docletArtifact />
  </docletArtifacts>
  <tagletArtifacts>
    <tagletArtifact />
  </tagletArtifacts>
  <links>
    <link>https://docs.oracle.com/en/java/javase/14/docs/api/</link>
  </links>
  <javadocResourcesDirectory>javadoc/resources</javadocResourcesDirectory>
</javadocOptions>

Answer 1

根据 Apache Maven 问题：https://issues.apache.org/jira/browse/MJAVADOC-623 ，这是 Maven JavaDoc 插件版本 3.1.1 中的一个错误。

您可以通过尝试使用版本 3.1.0 来“纠正”错误，或者使用该插件发布时的修复版本（在撰写本文时，它尚未发布）。

编辑（1）：

解决方法是将maven.compiler.release属性添加到 Maven 项目文件中：

<project>
  <properties>
    <maven.compiler.release>11</maven.compiler.release>
  </properties>
</project>

编辑（2）：

解决方法是在 Maven JavaDoc 插件中指定 Java 版本：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-javadoc-plugin</artifactId>
  <version>3.2.0</version>
  <executions>
    <execution>
      <id>main-javadoc</id>
      <phase>package</phase>
      <goals>
        <goal>jar</goal>
      </goals>
      <configuration>
        <release>11</release>
      </configuration>
    </execution>
  </executions>
</plugin>