多模块Maven项目Javadoc聚合阶段排除指定Java文件问题

针对多模块Maven项目中javadoc聚合阶段无法排除file2.java的问题，可按以下步骤处理：

1. 精简并确认排除规则 #

保留最通用的匹配规则，避免冗余规则导致冲突，仅需以下配置即可覆盖所有模块下的file2.java及相关文件：

<sourceFileExcludes>
    <exclude>**/file1.*</exclude>
    <exclude>**/file2.*</exclude>
</sourceFileExcludes>

**/会匹配任意层级的目录，确保所有子模块、任意路径下的file2相关文件都被命中。

2. 为聚合目标单独配置排除规则 #

全局配置可能无法完全作用于aggregate目标，需在对应的execution块内单独配置规则，确保聚合阶段加载排除逻辑：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>3.5.0</version> <!-- 升级至较新版本修复潜在bug -->
    <configuration>
        <doclint>none</doclint>
        <useStandardDocletOptions>false</useStandardDocletOptions>
        <!-- 全局配置，适用于单个模块的javadoc生成 -->
        <sourceFileExcludes>
            <exclude>**/file1.*</exclude>
            <exclude>**/file2.*</exclude>
        </sourceFileExcludes>
    </configuration>
    <executions>
        <execution>
            <id>aggregate</id>
            <goals>
                <goal>aggregate</goal>
            </goals>
            <!-- 为聚合目标单独配置，确保规则生效 -->
            <configuration>
                <sourceFileExcludes>
                    <exclude>**/file1.*</exclude>
                    <exclude>**/file2.*</exclude>
                </sourceFileExcludes>
            </configuration>
        </execution>
    </executions>
</plugin>

3. 升级maven-javadoc-plugin版本 #

你当前使用的3.0.1版本较旧，存在多模块聚合时路径匹配的潜在问题，升级至3.5.0及以上版本可解决部分兼容性问题。

4. 排查日志定位问题 #

执行命令时添加-X参数查看详细日志：

mvn install javadoc:javadoc javadoc:aggregate -X

在日志中搜索sourceFileExcludes，确认排除规则是否被正确加载；同时搜索file2.java，查看该文件是否被标记为“排除”或仍被扫描，进一步定位路径匹配问题。

内容的提问来源于stack exchange，提问作者tanishq chugh