带有maven的Java 11/12 Javadoc无法生成用于测试的Javadocs

Question

我有一个具有以下结构的小项目：

pom.xml

src/main/java/
  module-info.java
  de.ps.pl.te/
    package-info.java
    TE.java

src/test/java/
   de.ps.pl.te.test/
     package-info.java
     TETests.java

同样在我的maven pom中，我定义了javadoc插件，如下所示：

      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>3.1.0</version>
        <configuration>
          <show>protected</show>
          <failOnError>false</failOnError>
        </configuration>
      </plugin>

现在我在跑步过程中得到了一些奇怪的输出

mvn clean install site

[INFO]生成“ Javadoc”报告--- maven-javadoc-plugin：3.1.0：aggregate-no-fork [错误]提取链接时出错：D：\ work \ eclipse \ java \ FritzBox \ phplib \ target \ javadoc-捆绑选项。忽略它。

[...]

[INFO]生成“ Test Javadoc”报告--- maven-javadoc-plugin：3.1.0：test-aggregate-no-fork

[错误]提取链接时出错：D：\ work \ eclipse \ java \ FritzBox \ phplib \ target \ javadoc-bundle-options。忽略它。

正在加载软件包de.ps.pl.te.test的源文件...

1个错误

[错误]创建javadoc报告时出错：

退出代码：2-Javadoc：错误-软件包de.powerstat.phplib.templateengine.test没有源文件

命令行为：[...] javadoc.exe @options @packages

请参考“ [...]”目录中生成的Javadoc文件。

org.apache.maven.reporting.MavenReportException：

退出代码：2-javadoc：错误-没有软件包de.ps.pl.te.test的源文件

命令行为：[...] javadoc.exe @options @packages

请参考“ [...] \ target \ site \ testapidocs”目录中生成的Javadoc文件。

在org.apache.maven.plugins.javadoc.AbstractJavadocMojo.executeJavadocCommandLine（AbstractJavadocMojo.java:5761）

在org.apache.maven.plugins.javadoc.AbstractJavadocMojo.executeReport（AbstractJavadocMojo.java:2148）

在org.apache.maven.plugins.javadoc.TestJavadocReport.executeReport（TestJavadocReport.java:162）

[...]

我研究了以下问题：

• Maven，javadoc：没有包的源文件

但是我的问题似乎有所不同，并且基于Java模块化。所以问题是如何解决-还是要报告错误？

编辑1

现在，我尝试使用JDK 11.0.3和JDK 12.0.1-由于Oracle证书和服务器问题，我无法下载OpenJDK-因此我无法测试OpenJDK 13的早期访问。

有趣的一点是，使用版本11/12时，错误消息略有不同。

使用JDK 11时，错误是：

退出代码：1-Project \ src \ main \ java \ module-info.java：12：错误：找不到模块：org.apache.logging.log4j需要org.apache.logging.log4j；

使用JDK 12时，错误为：

退出代码：1-错误：找不到模块：de.powerstat.phplib.templateengine

其余消息仍然相同。

我也发现了一个可能涉及到的错误报告：

Javadoc在多版本jar中不支持module-info

我也试图排除模块info.java没有成功：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-javadoc-plugin</artifactId>
  <version>3.1.0</version>
  <configuration>
    <show>protected</show>
    <failOnError>false</failOnError>
    <sourceFileExcludes>
      <sourceFileExclude>**/module-info.java</sourceFileExclude>
    </sourceFileExcludes>
  </configuration>
</plugin>

编辑2

在target \ site \ apidocs中，我可以找到以下（是否生成了吗？）文件：

• argfile
• javadoc.bat
• 选项
• 包装

argfile：

'D:/TemplateEngine/src/main/java/de/ps/pl/te/package-info.java'
'D:/TemplateEngine/src/main/java/de/ps/pl/te/TemplateEngine.java'

javadoc.bat：

D:\Programme\Java\jdk-11.0.3\bin\javadoc.exe @options @argfile

套餐：

de.powerstat.phplib.templateengine
de.powerstat.phplib.templateengine

选项：

--module-path
'C:/.m2/repository/org/apache/logging/log4j/log4j-api/2.11.2/log4j-api-2.11.2.jar;C:/.m2/repository/org/apache/logging/log4j/log4j-core/2.11.2/log4j-core-2.11.2.jar'
-sourcepath
'D:/TemplateEngine/src/main/java'
-d
'D:/TemplateEngine/target/site/apidocs'
-linkoffline
'https://docs.oracle.com/en/java/javase/11/docs/api' 'D:/TemplateEngine/target/javadoc-bundle-options'
[Removed uninteresting parts like encoding, title etc.]

对于有人想亲自尝试的情况，我现在在GitHub上提供了整个项目

Answer 1

在测试时我看到了这个错误

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-site-plugin:3.7.1:site (default-site) on project templateengine: Execution default-site of goal org.apache.maven.plugins:maven-site-plugin:3.7.1:site failed: could not find reports directory [C:\tmp\TemplateEngine\target\pit-reports]
[ERROR]
[ERROR] Please copy and paste the information and the complete stacktrace below when reporting an issue
[ERROR] VM : OpenJDK 64-Bit Server VM
[ERROR] Vendor : Oracle Corporation
[ERROR] Version : 12.0.1+12
[ERROR] Uptime : 146619
[ERROR] Input ->
[ERROR]  1 : -Dclassworlds.conf=C:/ProgramData/chocolatey/lib/maven/apache-maven-3.6.1/bin/m2.conf
[ERROR]  2 : -Dmaven.home=C:/ProgramData/chocolatey/lib/maven/apache-maven-3.6.1
[ERROR]  3 : -Dlibrary.jansi.path=C:/ProgramData/chocolatey/lib/maven/apache-maven-3.6.1/lib/jansi-native
[ERROR]  4 : -Dmaven.multiModuleProjectDirectory=C:/tmp/TemplateEngine
[ERROR] BootClassPathSupported : false

刚刚创建了文件夹“mkdir ./target/pit-reports”，然后它就消失了。这就是问题所在

<show>private</show>

所以我们可以说您在 maven-javadoc-plugin 中发现了一个错误:)