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>

带有Maven的JavaDoc生成“错误获取链接：”

1 个答案: