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

Question

我有一个简单的项目，使用src / main / java / test / Test.javapackage 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>

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

    <version>3.1.0</version>

    <configuration>

        <doclint>all</doclint>

    </configuration>

    <executions>

        <execution>

            <id>attach-javadocs</id>

            <goals>

                <goal>jar</goal>

            </goals>

        </execution>

    </executions>

</plugin>