当 Javadoc 标记不完整时，Maven 无法在 Java 8 中运行

最好的解决方案是修复 javadoc 错误。如果由于某种原因不可能（即：自动生成的源代码），那么您可以禁用此检查。

DocLint is a new feature in Java 8，总结如下：

提供一种在开发周期早期检测 Javadoc 注释中的错误的方法，并且可以轻松链接回源代码。

这是默认启用的，并且会在生成 Javadocs 之前运行大量检查。您需要按照指定的 in this thread 为 Java 8 关闭此功能。您必须将其添加到您的 Maven 配置中：

<profiles>
  <profile>
    <id>java8-doclint-disabled</id>
    <activation>
      <jdk>[1.8,)</jdk>
    </activation>
    <properties>
      <javadoc.opts>-Xdoclint:none</javadoc.opts>
    </properties>
  </profile>
</profiles>
<build>
  <plugins>
    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>2.9</version>
        <executions>
            <execution>
                <id>attach-javadocs</id>
                <goals>
                    <goal>jar</goal>
                </goals>
                <configuration>
                    <additionalparam>${javadoc.opts}</additionalparam>
                </configuration>
            </execution>
        </executions>
    </plugin>
    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-site-plugin</artifactId>
        <version>3.3</version>
        <configuration>
          <reportPlugins>
            <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-javadoc-plugin</artifactId>
              <configuration>
                <additionalparam>${javadoc.opts}</additionalparam>
              </configuration>
            </plugin>
          </reportPlugins>
        </configuration>
      </plugin>
   </plugins>
</build>

对于 maven-javadoc-plugin 3.0.0+：替换

<additionalparam>-Xdoclint:none</additionalparam>

和

<doclint>none</doclint>

使用 java 8 和 java 7 的最简单方法是在构建中使用配置文件：

<profiles>
  <profile>
    <id>doclint-java8-disable</id>
    <activation>
      <jdk>[1.8,)</jdk>
    </activation>

    <build>
      <plugins>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-javadoc-plugin</artifactId>
          <configuration>
            <additionalparam>-Xdoclint:none</additionalparam>
          </configuration>
        </plugin>
      </plugins>
    </build>
  </profile>
</profiles>

这是我知道忽略doclint警告的最简洁的方法，无论使用什么java版本。无需在多个配置文件中复制插件配置，只需稍作修改。

<profiles>
  <profile>
    <id>doclint-java8-disable</id>
    <activation>
      <jdk>[1.8,)</jdk>
    </activation>
    <properties>
      <javadoc.opts>-Xdoclint:none</javadoc.opts>
    </properties>
  </profile>
</profiles>

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-javadoc-plugin</artifactId>
      <version>2.9.1</version>
      <executions>
        <execution>
          <id>attach-javadocs</id> <!-- The actual id should be apparent from maven output -->
          <configuration>
            <additionalparam>${javadoc.opts}</additionalparam>
          </configuration>
        </execution>
      </executions>
    </plugin>
    ...
  </plugins>
</build>

在 oracle/open jdk 6、7、8 和 11 上测试。

适用于任何 Java 版本的最短解决方案：

<profiles>
    <profile>
        <id>disable-java8-doclint</id>
        <activation>
            <jdk>[1.8,)</jdk>
        </activation>
        <properties>
            <additionalparam>-Xdoclint:none</additionalparam>
        </properties>
    </profile>
</profiles>

只需将其添加到您的 POM 中，您就可以开始使用了。

这基本上是 @ankon's answer 加上 @zapp's answer。

对于 maven-javadoc-plugin 3.0.0 用户：

代替

<additionalparam>-Xdoclint:none</additionalparam>

经过

<doclint>none</doclint>

添加到 pom 文件中的全局属性部分：

<project>
    ...
    <properties>
        <additionalparam>-Xdoclint:none</additionalparam>
    </properties>

其他答案中提供的通用解决方案（在插件部分添加该属性）由于某种原因不起作用。只有通过全局设置，我才能成功构建 javadoc jar。

我不认为仅仅关闭 DocLint 是一个好的解决方案，至少不是长期的。 Javadoc 变得更加严格是件好事，因此修复构建问题的正确方法是修复底层问题。是的，您最终需要修复这些源代码文件。

以下是您之前可以避免的需要注意的事项：

格式错误的 HTML（例如缺少结束标记、未转义的括号等）

{@link } 无效。 （类似的标签也一样，比如@see）

@author 值无效。这曾经被接受：@author John 但由于未转义的括号而不再如此。

Javadoc 中的 HTML 表格现在需要摘要或标题。请参阅此问题以获取解释。

您只需修复您的源代码文件并继续构建您的 Javadoc，直到它可以构建而不会失败。是的，很麻烦，但我个人喜欢将我的项目提升到 DocLint 级别，因为这意味着我可以更加确信我生成的 Javadoc 确实是我想要的。

如果您在一些您自己没有生成的源代码上生成 Javadoc，例如因为它来自某个代码生成器，例如 wsimport，那么当然会出现问题。奇怪的是，Oracle 在实际发布 JDK8 之前并没有为 JDK8 合规性准备自己的工具。看起来it won't be fixed until Java 9。仅在这种特殊情况下，我建议关闭本页其他地方记录的 DocLint。

仅覆盖 maven-javadoc-plugin 配置，不能解决 mvn site 的问题（例如在发布阶段使用）。这是我必须做的：

<profile>
  <id>doclint-java8-disable</id>
  <activation>
    <jdk>[1.8,)</jdk>
  </activation>
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <configuration>
          <additionalparam>-Xdoclint:none</additionalparam>
        </configuration>
      </plugin>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-site-plugin</artifactId>
        <version>3.3</version>
        <configuration>
          <reportPlugins>
            <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-javadoc-plugin</artifactId>
              <configuration>
                <additionalparam>-Xdoclint:none</additionalparam>
              </configuration>
            </plugin>
          </reportPlugins>
        </configuration>
      </plugin>
    </plugins>
  </build>
</profile>

您可以尝试将 failOnError 属性（请参阅 plugin documentation）设置为 false：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.9</version>
    <executions>
        <execution>
            <id>attach-javadocs</id>
            <goals>
                <goal>jar</goal>
            </goals>
            <configuration>
              <failOnError>false</failOnError>
            </configuration>
        </execution>
    </executions>
</plugin>

正如您从文档中看到的，默认值为 true。

由于它取决于用于运行 maven 命令的 JRE 的版本，因此您可能不想在 pom.xml 中默认禁用 DocLint

因此，您可以从命令行使用开关 -Dadditionalparam=-Xdoclint:none。

示例：mvn clean install -Dadditionalparam=-Xdoclint:none

配置属性名称已在 maven-javadoc-plugin 的最新版本 3.0.0 中更改。

因此 将不起作用。所以我们必须修改它如下。

   <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-javadoc-plugin</artifactId>
      <version>3.0.0</version>
      <configuration>
         <doclint>none</doclint>
      </configuration>
  </plugin>

我想对其他答案添加一些见解

就我而言

-Xdoclint：无

没用。

让我们从这个开始，在我的项目中，我根本不需要 javadoc。只有一些必要的插件对它有构建时间依赖。

因此，解决我的问题的最简单方法是：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <configuration>
        <skip>true</skip>
    </configuration>
</plugin>

从 maven-javadoc-plugin 3.0.0 开始，您应该已经使用 additionalJOption 来设置额外的 Javadoc 选项，因此如果您希望 Javadoc 禁用 doclint，您应该添加以下属性。

<properties>
    ...
    <additionalJOption>-Xdoclint:none</additionalJOption>
    ...
<properties>

您还应该提及 maven-javadoc-plugin 的版本为 3.0.0 或更高版本。

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>3.0.0</version>    
</plugin>

所以，为自己节省一些我没有的时间，如果它似乎不起作用，试试这个：

 <additionalJOption>-Xdoclint:none</additionalJOption>

标签已针对较新的版本进行更改。

在下面添加

JAVA_TOOL_OPTIONS=-DadditionalJOption=-Xdoclint:none

进入詹金斯工作：

配置 > 构建环境 > 将环境变量注入构建过程 > 属性内容

通过 Jenkins Maven 解决了我的代码构建问题 :-)

我不确定这是否会有所帮助，但即使我最近在使用 oozie-4.2.0 版本时也遇到了完全相同的问题。在阅读了上述答案后，我刚刚通过命令行添加了 maven 选项，它对我有用。所以，就在这里分享一下。

我正在使用 java 1.8.0_77，尚未尝试使用 java 1.7

bin/mkdistro.sh -DskipTests -Dmaven.javadoc.opts='-Xdoclint:-html'

要忽略缺少的 @param 和 @return 标记，禁用 missing doclint group 就足够了。这样，仍将检查 javadoc 是否存在更高级别和语法问题：

    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>3.0.0</version>
        <configuration>
            <doclint>all,-missing</doclint>
        </configuration>
    </plugin>

请注意，这适用于插件版本 3.0 或更高版本。

我参加聚会有点晚了，但我也被迫寻找解决方法，最终来到这里，然后找到了它。

这对我有用：-

export JAVA_TOOL_OPTIONS=-DadditionalJOption=-Xdoclint:none

然后开始你的 Maven 构建，任何 Linux 发行版构建等等。它不需要修改 Maven 配置文件 - 我不能这样做，因为我的目标是重建一堆 Centos rpm 包，所以不得不走得很深。

在我的情况下，我使用的是父 pom（不确定这是真正的原因，因为我在争分夺秒地运行），使用了 maven 2.x 和 java 1.6，由于某种原因，上述解决方案不起作用，所以我添加了以下配置文件并对其进行管理以使其运行：

<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/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.mycompany</groupId>
    <artifactId>myapp</artifactId>
    <packaging>war</packaging>
    <name>myapp</name>
    <version>0.0.1-SNAPSHOT</version>
    <description>My App</description>
    <parent>
        <groupId>com.mycompany</groupId>
        <artifactId>parent-artifact</artifactId>
        <version>0.0.1</version>
    </parent>

    <profiles>
        <profile>
            <id>doclint-java6-disable</id>
            <activation>
                <jdk>[1.6,)</jdk>
            </activation>
            <properties>
                <additionalparam>--allow-script-in-comments</additionalparam>
            </properties>
        </profile>
    </profiles>
</project>