mvn release:perform 在 java 8 中失败 - 添加了 javadoc 插件答案

【问题标题】：mvn release:perform fails in java 8 - added javadoc pluginmvn release:perform 在 java 8 中失败 - 添加了 javadoc 插件
【发布时间】：2016-03-25 02:09:31
【问题描述】：

我在运行 release:perform 时遇到问题，使用 Java 8 和 maven 3.0.5。生成 Javadoc 时出现错误。我添加了 javadoc 插件：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <executions>
        <execution>
            <id>attach-javadocs</id>
            <goals>
                <goal>jar</goal>
            </goals>
            <configuration>
               <additionalparam>-Xdoclint:none</additionalparam>
            </configuration>
        </execution>
    </executions>
</plugin>

奇怪的是，当我运行“mvn javadoc:javadoc”或“mvn javadoc:jar”时它运行良好。有没有人可以解决这个问题？

生成所有内容后出现此错误：

Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:2.10.3:jar (attach-javadocs) on project sdm: MavenReportException: Error while generating Javadoc:
[INFO] [ERROR] C:\dir...\JavaClass.java:50: error: self-closing element not allowed
[INFO] [ERROR] * <p/>
[INFO] [ERROR] ^
[INFO] [ERROR]
[INFO] [ERROR] Command line was: "C:\Program Files\Java\jdk1.8.0_60\jre\..\bin\javadoc.exe" @options @packages
[INFO] [ERROR]
[INFO] [ERROR] Refer to the generated Javadoc files in 'C:\dir.....\' dir.

【问题讨论】：

请提供准确的错误信息。
如果可能的话，请提供完整的错误信息，以及错误之前发生的日志输出。
它会生成所有内容（就像我运行 mvn javadoc:javadoc 时一样），但随后“执行失败...”出现大量错误，类似于第一个错误（自关闭元素不允许）。然后出现“命令行是...”。
只是一个想法：尝试将<configuration> 移动到与<executions> 相同的级别，而不是使其特定于单个执行。
好吧，我会检查源代码并将所有出现的<p/> 替换为<p>。使用需要几秒钟的 IDE 或专用工具……

标签： java maven java-8 javadoc release

【解决方案1】：

不幸的是；我无法用提供的信息告诉你为什么发布插件不尊重“-Xdoclint:none”。

但“简单”的修复可能只是完全删除参数并实际修复编译器报告的 Javadoc 问题（例如不允许的自关闭元素）。

【讨论】：

几个月前将一个大项目迁移到 java 8，我可以告诉你这不是“简单”的修复 ;-)

【解决方案2】：

尝试为 java 8 完全禁用 doc linting：

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

在这里找到它：https://issues.shibboleth.net/jira/browse/JPAR-73

【讨论】：