17 回答

• 26

  我想补充一些其他答案的见解

  在我的情况下

  -Xdoclint：无

  没工作 .

  首先，在我的项目中，我根本不需要javadoc . 只有一些必要的插件才具有构建时依赖性 .

  所以，解决我的问题最简单的方法是：

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

  回复于 2024-04-24T21:40:03+08:00
• 37

  要忽略缺少的 @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或更高版本的插件 .

  回复于 2024-04-24T21:40:03+08:00
• 17

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

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

  提供一种在开发周期早期以一种易于链接回源代码的方式检测Javadoc注释中的错误的方法 .

  默认情况下启用此选项，并在生成Javadoc之前运行大量检查 . 您需要按照指定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>
  

  For maven-javadoc-plugin 3.0.x: 替换

  <additionalparam>-Xdoclint:none</additionalparam>
  

  同

  <doclint>none</doclint>
  

  回复于 2024-04-24T21:40:03+08:00
• 0

  仅覆盖 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>
  

  回复于 2024-04-24T21:40:03+08:00
• 55

  您可以尝试将 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 .

  回复于 2024-04-24T21:40:03+08:00
• 30

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

  我正在使用java 1.8.0_77 ，还没试过java 1.7

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

  回复于 2024-04-24T21:40:03+08:00
• 33

  这是我所知道的最简洁的方法，无论使用的是哪个版本，都会忽略doclint警告 . 无需在略有修改的情况下在多个配置文件中复制插件配置 .

  <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上测试过 .

  回复于 2024-04-24T21:40:03+08:00
• 93

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

  因此<additionalparam>将无效 . 所以我们必须修改如下 .

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

  回复于 2024-04-24T21:40:03+08:00
• 2

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

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

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

  回复于 2024-04-24T21:40:03+08:00
• 2

  适用于任何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>

  回复于 2024-04-24T21:40:03+08:00
• 2

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

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

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

  回复于 2024-04-24T21:40:03+08:00
• 1

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

  <additionalJOption>-Xdoclint:none</additionalJOption>
  

  标签会针对较新版本进行更改 .

  回复于 2024-04-24T21:40:03+08:00
• 18

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

  以下是您可以注意的事项：

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

  • 无效 {@link } s . （同样适用于类似的标签，如 @see ）

  • 无效的 @author 值 . 这曾经被接受： @author John <john.doe@mine.com> 但由于未转义的括号而不再如此 .
    现在，Javadoc中的

  • HTML表需要摘要或 Headers . 有关说明，请参见this question .

  您只需修复源代码文件并继续构建Javadoc，直到它可以构建而不会出现故障 . 很麻烦是的，但我个人喜欢当我将我的项目提升到DocLint级别时，因为这意味着我可以更自信我 生产环境 的Javadoc实际上是我想要的 .

  因为它来自某些代码生成器，例如，所以没有自己产生's of course the problem if you are generating Javadoc on some source code you' . wsimport . 奇怪的是，在实际发布JDK8之前，Oracle没有为JDK8合规准备自己的工具 . 好像it won't be fixed until Java 9 . 只有在这种特殊情况下，我建议关闭本页其他地方记录的DocLint .

  回复于 2024-04-24T21:40:03+08:00
• 339

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

  回复于 2024-04-24T21:40:03+08:00
• 7

  我参加派对有点晚了，但我也被迫寻找解决方法，最后来到这里，然后找到了 .

  这对我有用： -

  export JAVA_TOOL_OPTIONS=-DadditionalJOption=-Xdoclint:none
  

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

  回复于 2024-04-24T21:40:03+08:00
• 0

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

  回复于 2024-04-24T21:40:03+08:00
• 1

  在下面添加

  JAVA_TOOL_OPTIONS = -DadditionalJOption = -Xdoclint：无

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

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

  回复于 2024-04-24T21:40:03+08:00