Maven Javadoc插件3.5.0:如何修复“无法导出模块描述符”错误?

voase2hg  于 2023-03-28  发布在  Java
关注(0)|答案(1)|浏览(191)

bounty已结束,回答此问题可获得+50声望奖励,奖励宽限期18小时后结束,Geoffrey De Smet希望引起更多关注此问题。

我正在构建一个附带maven-javadoc-plugin的Maven项目。
更新到maven-javadoc-plugin 3.5.0后,在运行jar目标时出现此错误:

Execution build-javadoc-jar of goal org.apache.maven.plugins:maven-javadoc-plugin:3.5.0:jar failed:
  Unable to derive module descriptor for /.../rewrite-gradle-7.38.0.jar
  PluginSpec.class found in top-level directory (unnamed package not allowed in module)

我不控制第三方的依赖性,也不使用JPMS。
有没有办法告诉javadoc工具忽略模块命名?
Source code that reproduces the problem

<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 https://maven.apache.org/xsd/maven-4.0.0.xsd">

  <modelVersion>4.0.0</modelVersion>

  <groupId>reproducer</groupId>
  <artifactId>reproducer</artifactId>
  <version>0.1</version>

  <build>
    <pluginManagement>
      <plugins>
        <plugin>
          <artifactId>maven-compiler-plugin</artifactId>
          <version>3.11.0</version>
        </plugin>
        <plugin>
          <artifactId>maven-jar-plugin</artifactId>
          <version>3.3.0</version>
          <configuration>
            <archive>
              <manifestEntries>
                <Automatic-Module-Name>org.acme.reproducer</Automatic-Module-Name>
              </manifestEntries>
            </archive>
          </configuration>
        </plugin>
        <plugin>
          <artifactId>maven-javadoc-plugin</artifactId>
          <version>3.5.0</version><!-- Regression from 3.2.0 which did not have the problem-->
        </plugin>
      </plugins>
    </pluginManagement>
    <plugins>
      <plugin>
        <artifactId>maven-javadoc-plugin</artifactId>
        <executions>
          <execution>
            <goals>
              <goal>jar</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>

  <dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>org.openrewrite.recipe</groupId>
        <artifactId>rewrite-recipe-bom</artifactId>
        <version>1.17.0</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
    </dependencies>
  </dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.openrewrite</groupId>
      <artifactId>rewrite-gradle</artifactId>
    </dependency>
  </dependencies>
</project>
svmlkihl

svmlkihl1#

要禁用模块描述符的生成,避免出现错误,可以配置maven-javadoc-plugin使用**--add-modules选项,参数列表为空,该选项指示javadoc工具忽略JPMS配置。
为此,请在
maven-javadoc-plugin**中添加以下配置:

<configuration>
  <additionalOptions>
    <option>--add-modules</option>
    <option></option>
  </additionalOptions>
</configuration>

完整的插件配置如下所示:

<plugin>
  <artifactId>maven-javadoc-plugin</artifactId>
  <version>3.5.0</version>
  <executions>
    <execution>
      <goals>
        <goal>jar</goal>
      </goals>
    </execution>
  </executions>
  <configuration>
    <additionalOptions>
      <option>--add-modules</option>
      <option></option>
    </additionalOptions>
  </configuration>
</plugin>

通过这种配置,***maven-javadoc-plugin***应该能够生成Javadoc jar,而无需尝试为有问题的依赖项派生模块描述符。

相关问题