Maven JavaDoc插件无法将本地外部依赖的JavaDoc纳入最终文档

你之前配置的<links>标签仅用于生成指向外部JavaDoc的跳转链接，并不会将B的文档内容合并到A的JavaDoc中，这就是配置无报错但未生效的原因。以下是两种实现合并的有效方案：

方案一：通过源码路径合并（推荐，文档结构统一） #

如果能访问到项目B的源码，可直接让javadoc工具同时处理A和B的源码，生成结构统一的合并文档。修改A的maven-javadoc-plugin配置：

<plugin>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>3.1.0</version>
    <configuration>
        <doclint>none</doclint>
        <!-- 追加B项目的源码路径，根据实际目录调整 -->
        <sourcepath>${project.basedir}/../MyDependency/src/main/java</sourcepath>
        <!-- 可选：排除B中不需要的包 -->
        <!-- <excludes>**/com/example/unwanted/**</excludes> -->
    </configuration>
    <executions>
        <execution>
            <id>attach-javadocs</id>
            <goals>
                <goal>jar</goal>
            </goals>
        </execution>
    </executions>
</plugin>

执行mvn clean package后，生成的JavaDoc会同时包含A和B的所有类文档，且导航结构一致。

方案二：合并已生成的HTML文档 #

若不想依赖B的源码，可直接将B已生成的JavaDoc（HTML文件）复制到A的文档输出目录：

1. 先在B项目中执行mvn javadoc:javadoc生成HTML文档
2. 在A的pom.xml中添加maven-resources-plugin配置，实现文件复制：

<plugin>
    <artifactId>maven-resources-plugin</artifactId>
    <version>3.3.1</version>
    <executions>
        <execution>
            <id>copy-b-javadoc</id>
            <!-- 绑定到package阶段，在A生成JavaDoc后执行复制 -->
            <phase>package</phase>
            <goals>
                <goal>copy-resources</goal>
            </goals>
            <configuration>
                <outputDirectory>${project.build.directory}/apidocs</outputDirectory>
                <resources>
                    <resource>
                        <!-- B的JavaDoc输出目录，替换为你的实际路径 -->
                        <directory>/Users/chris/workspace/MyDependency/target/apidocs</directory>
                        <includes>
                            <include>**/*</include>
                        </includes>
                    </resource>
                </resources>
            </configuration>
        </execution>
    </executions>
</plugin>

执行mvn clean package后，A的target/apidocs目录会包含A和B的所有HTML文档。

注意事项 #

• 方案一需确保B的源码路径正确，且B的依赖能被A正常访问，避免javadoc编译报错
• 方案二合并后，两套文档的导航结构是独立的，若需统一导航需手动调整HTML内容

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