JavaDoc with Maven generates 'Error fetching link:'

Question

Generating a JavaDoc with Maven I get an error message 'Error fetching link:' referring to a file javadoc-bundle-options. In it it contains javadocResourcesDirectory with a directory. Even if I create that directory I still get the same error. How can I correct the error?

    <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>

Osmund Francis · Accepted Answer · 2020-09-25 12:47:54Z

4

According to the Apache Maven Issue: https://issues.apache.org/jira/browse/MJAVADOC-623 this is a bug in the Maven JavaDoc Plugin version 3.1.1.

You can "correct" the error by trying to use version 3.1.0, or use the fixed version of the plugin when it is released (at time of writing this, it still hasn't been released).

EDIT (1):

A workaround is to add the maven.compiler.release property to the Maven project file:

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

EDIT (2):

A workaround is to specify the Java release in the Maven JavaDoc Plugin:

<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>

edited Sep 25, 2020 at 12:47

answered Sep 25, 2020 at 3:00

Osmund Francis

84112 silver badges27 bronze badges

Sign up to request clarification or add additional context in comments.

1 Comment

Osmund Francis Over a year ago

Maven JavaDoc plugin 3.2.0 is also affected by this bug.

Collectives™ on Stack Overflow

JavaDoc with Maven generates 'Error fetching link:'

1 Answer 1

1 Comment

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

1 Answer 1

1 Comment

Your Answer

Sign up or log in

Post as a guest

Related