Javadoc在Oracle JDK上失败，但在OpenJDK上不失败

Question

我有一个简单的项目，使用src / main / java / test / Test.java

package test;

/**

 * Class java doc

 */ 

public class Test

{

    /**

     * Wrong java doc

     *

     * @param test

     * @return 

     */

    public int aMethod(int param){

        return 0;

    }

}

和pom.xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<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.test</groupId>

  <artifactId>test</artifactId>

  <version>1.0.0-SNAPSHOT</version>

  <build>

      <plugins>

      <plugin>

        <groupId>org.apache.maven.plugins</groupId>

        <artifactId>maven-compiler-plugin</artifactId>

        <version>3.0</version>

        <configuration>

          <source>1.8</source>

          <target>1.8</target>

          <encoding>UTF-8</encoding>

        </configuration>

      </plugin>

      <plugin>

        <groupId>org.apache.maven.plugins</groupId>

        <artifactId>maven-javadoc-plugin</artifactId>

        <version>3.0.0</version>

        <executions>

          <execution>

            <id>attach-javadocs</id>

            <goals>

              <goal>jar</goal>

            </goals>

          </execution>

        </executions>

      </plugin>

    </plugins>

  </build>

</project>

在使用oracle-jdk8（161）的Linux上构建时，由于Javadoc错误而失败

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:3.0.0:jar (attach-javadocs) on project test: MavenReportException: Error while generating Javadoc: 

[ERROR] Exit code: 1 - /home/D070061/SAPDevelop/test/src/main/java/test/Test.java:10: error: @param name not found

[ERROR]      * @param test

使用open-jdk8（v171）进行相同的操作时，构建成功

我用 sudo update-alternatives --config java

有人知道为什么它在OpenJDK上不会失败吗？是一个错误还是需要一些特殊的参数？

Answer 1

看起来Debian修补了javadoc以默认情况下禁用doclint，就像某些派生的发行版和其他发行版一样。Maven Javadoc插件<doclint>在3.0.0中添加了一个配置项，因此对于该版本及更高版本，您应该能够通过指定以下内容重新启用doclint：<plugin>&nbsp; &nbsp; <artifactId>maven-javadoc-plugin</artifactId>&nbsp; &nbsp; <version>3.1.0</version>&nbsp; &nbsp; <configuration>&nbsp; &nbsp; &nbsp; &nbsp; <doclint>all</doclint>&nbsp; &nbsp; </configuration>&nbsp; &nbsp; <executions>&nbsp; &nbsp; &nbsp; &nbsp; <execution>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <id>attach-javadocs</id>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <goals>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <goal>jar</goal>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </goals>&nbsp; &nbsp; &nbsp; &nbsp; </execution>&nbsp; &nbsp; </executions></plugin>