将Jitpack库添加至IntelliJ构建系统时遇下载失败问题

1. 先全局配置Jitpack仓库 #

别只单独添加单个库，先让IntelliJ的构建系统能识别Jitpack的仓库源：

• 打开File > Settings > Build, Execution, Deployment > Build Tools > Maven > Repositories
• 点击+号新增仓库：
  • ID填jitpack.io
  • URL填https://jitpack.io
• 选中该仓库，点击Update按钮刷新仓库索引

2. 核对依赖坐标的正确性 #

Jitpack的依赖格式和普通Maven不同，务必确认坐标无拼写错误：

• 正确格式为com.github.用户名:仓库名:版本号，例如com.github.Gureumi:MyRepo:v2.1.0
• 去Jitpack对应仓库页面（直接搜索仓库名）确认可用的版本号与坐标格式

3. 调整Maven镜像的排除规则 #

如果你的Maven使用了国内镜像（比如阿里云），可能会拦截Jitpack的请求，需要修改settings.xml：

• 找到本地Maven的settings.xml（路径一般为~/.m2/settings.xml，或IntelliJ配置中指定的Maven路径）
• 在<mirrors>节点内添加排除Jitpack的规则：

<mirrors>
  <mirror>
    <id>aliyunmaven</id>
    <mirrorOf>*,!jitpack.io</mirrorOf>
    <url>https://maven.aliyun.com/repository/public</url>
  </mirror>
</mirrors>

4. 强制刷新依赖缓存 #

• 右键点击项目根目录，选择Maven > Reload Project
• 或者点击右侧Maven面板的刷新按钮（圆圈箭头图标）
• 若仍无效，手动删除本地Maven仓库中com/github/下对应依赖的文件夹，再重新刷新

5. 检查Jitpack上的构建状态 #

部分依赖可能因原仓库代码问题在Jitpack上构建失败，导致无包可下载：

• 去Jitpack搜索对应仓库，查看顶部的Build Status是否为绿色成功状态
• 若为红色失败，要么等待作者修复，要么更换一个能正常构建的版本

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