Maven JavaDoc 列出类两次

Question

我正在使用 javadoc maven 插件，它创建了正确的 javadoc 包，但是所有类都创建了两次。

Maven 依赖：

        <dependency>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>3.3.0</version>
    </dependency>

我的构建代码

<build>
            <plugins>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-javadoc-plugin</artifactId>
                    <executions>
                        <execution>
                            <id>attach-javadocs</id>
                            <goals>
                                <goal>jar</goal>
                            </goals>
                        </execution>
                    </executions>
                </plugin>
            </plugins>
        </build>

任何人都可以帮助我，我在这里缺少什么？

文档生成的命令用法

mvn clean install -Dresources="FirstProject/example_API"

Answer 1

我注意到同样的问题，并在 maven-javadoc-plugin maven 插件上启用调试并查看它在做什么后找到了解决方案。如下所示专门设置源路径为我修复了双重列表问题，我已经在 Corretto 8 和 Temurin 8 的多个版本上尝试过这个。所有都有双重列表问题，因为它是 javadoc 工具本身的问题但是设置sourcepath 为我手动修复了它。

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>3.3.1</version>
    <configuration>
        <debug>true</debug>
        <sourcepath>${basedir}/src/main/java</sourcepath>
    </configuration>
    <executions>
        <execution>
            <id>attach-javadocs</id>
            <goals>
                <goal>jar</goal>
            </goals>
        </execution>
    </executions>
</plugin>

Answer 2

Maven Javadoc Plugin. The bug is known as MJAVADOC-700 的最新版本中存在错误。它非常容易重现。

将插件降级到 3.2.0 版本可以解决问题。明确设置 sourcepath 是另一种修复方法。

Maven JavaDoc 列出 类 两次

Maven JavaDoc listed classes twice

java

javadoc

maven

Maven 依赖：

我的构建代码

Maven JavaDoc 列出类两次