You need to enable JavaScript to run this app. Maven打包含Jitpack依赖的Javadoc报错,除上传Maven外有何解法?
优惠活动
大模型
产品
解决方案
定价
更多

Maven打包含Jitpack依赖的Javadoc报错,除上传Maven外有何解法?

可行解决方案

报错核心原因是maven-javadoc-plugin执行打包时,默认仅从Maven中央仓库拉取依赖构件信息,未匹配到Jitpack源的Dream-Yaml组件。除了上传依赖到中央仓库外,可选择以下适配方案:

  • 方案1:排除无法拉取的非中央库依赖
    不需要将Jitpack来源依赖的Javadoc打入公共库Javadoc包时,直接在插件配置中添加排除规则即可,配置示例如下:

    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>3.6.3</version>
        <configuration>
            <includeDependencySources>true</includeDependencySources>
            <!-- 排除指定依赖,格式为groupId:artifactId -->
            <excludeDependencyNames>com.github.Osiris-Team:Dream-Yaml</excludeDependencyNames>
        </configuration>
    </plugin>
    

    如有多个需排除的依赖,用英文逗号分隔即可。

  • 方案2:为Maven添加Jitpack仓库配置
    需要将Jitpack来源依赖的Javadoc一同打包时,在公共库的pom.xml中添加Jitpack仓库配置,让Maven可以从Jitpack拉取对应构件信息,配置示例如下:

    <repositories>
        <repository>
            <id>jitpack.io</id>
            <url>https://jitpack.io</url>
        </repository>
    </repositories>
    <!-- 插件仓库也需要同步添加,否则插件拉取依赖时仍无法找到Jitpack源 -->
    <pluginRepositories>
        <pluginRepository>
            <id>jitpack.io</id>
            <url>https://jitpack.io</url>
        </pluginRepository>
    </pluginRepositories>
    

    配置完成后重新执行打包命令即可正常拉取Dream-Yaml的构件信息。

  • 方案3:本地预存依赖构件
    仅本地开发打包场景适用,可手动下载Dream-Yaml的pom、sources、javadoc包到本地Maven仓库对应的目录下,打包时Maven优先读取本地缓存,不会触发远程仓库查询。

  • 方案4:手动嵌入所需Javadoc资源
    可提前下载好需要包含的第三方依赖Javadoc资源,通过maven-resources-plugin将资源文件复制到Javadoc打包的输出目录,无需通过插件自动拉取依赖生成,适合需要自定义Javadoc内容的场景。

内容的提问来源于stack exchange,提问作者Osiris Team

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.17 12:45:03