使用maven-javadoc-plugin生成JavaDoc时所有类重复列出问题求助

解决方法 #

根因说明

你遇到的类重复生成问题有两个核心触发原因：

• 当前使用的maven-javadoc-plugin 3.3.0版本本身存在类扫描重复的已知缺陷
• 插件未明确绑定生命周期阶段、未指定源码路径，导致install阶段两次触发javadoc生成逻辑，重复扫描类文件

修复步骤

1. 升级插件到无缺陷的稳定版本，推荐使用3.6.3版本
2. 补充插件的执行配置，明确绑定生命周期、指定源码路径，避免重复扫描

修改后的完整配置如下：

Maven依赖配置

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

Build插件配置

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <version>3.6.3</version>
            <executions>
                <execution>
                    <id>attach-javadocs</id>
                    <!-- 明确绑定到package阶段，避免和install阶段的默认逻辑冲突 -->
                    <phase>package</phase>
                    <goals>
                        <goal>jar</goal>
                    </goals>
                    <configuration>
                        <!-- 明确指定源码目录，避免重复扫描多路径下的同包同类 -->
                        <sourcepath>${project.basedir}/src/main/java</sourcepath>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

临时备选方案

如果暂时不想修改配置，可在执行命令时添加参数跳过默认的javadoc执行逻辑：

mvn clean install -Dresources="FirstProject/example_API" -Dmaven.javadoc.skipDefaultExecution=true

内容的提问来源于stack exchange，提问作者Rana Mansoor