maven-javadoc-plugin不接受-xdoclint:none

Question

MVN release:perform由于未创建javadocs而失败。所以我试着跑

mvn javadoc:javadoc

我和我看到它失败了，因为源代码中的javadoc注释没有定义所有的参数和返回值。错误的格式如下：

Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:3.0.1:jar (attach-javadocs) on project my-project: MavenReportException: Error while generating Javadoc:

Exit code: 1 - /my/file.java:36: warning: no description for @return

然而，这曾经起作用。那是什么改变了？

当我搜索参数additionalParam时，它不会出现。我搞不懂这怎么会起作用。搜索答案有些人说使用我正在使用的东西，有些人说使用AdditionalJOption。当Javadoc标记不完整时，请参见Maven在Java8中不起作用。

有什么想法是什么导致的问题和如何解决它？

幸运的是，我找到了一个从命令行禁用Javadoc链接的方法：

mvn release:perform -Darugments="-Dmaven.javadoc.skip=true"

工藤的code.i-harness.com的帖子给了我这个工作。

所以我已经解决了最初的问题，但是我想/需要清理POM以移除无用的参数，或者将它们更改为新的/正确的语法（尚未测试）。

在SO上搜索会得到以下有用的点击：

>

如何从命令行禁用Maven Javadoc插件？-给了我搜索maven.javadoc.skip的想法，这帮助我找到了我的工作。

当Javadoc标记不完整时，Maven无法在Java8中工作，这意味着我应该使用additionaljoption参数。同一个问题的答案是使用我正在使用的 -xdoclint:none

Answer 1

您应该改用doclint选项：

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

这将跳过所有检查。通常，我建议运行所有检查，但缺少@return和@param除外。因此，您可以使用none，而不是：

        <doclint>all,-missing</doclint>

可以打开或关闭单个检查组（如上面的-missing)。这些组的详细描述可以在javadoc文档中找到（在页面底部）。