Android Java项目无法解析com.github.smarteist:autoimageslider:1.4.0依赖求助

问题概况 #

引入的依赖：

implementation 'com.github.smarteist:autoimageslider:1.4.0'

构建项目时触发以下错误链：

Caused by: org.gradle.internal.resolve.ModuleVersionResolveException: Could not resolve com.github.smarteist:autoimageslider:1.4.0.
Caused by: org.gradle.api.internal.artifacts.ivyservice.DefaultLenientConfiguration$ArtifactResolveException: Could not resolve all files for configuration ':app:debugRuntimeClasspath'.
Caused by: org.gradle.internal.resource.transport.http.HttpErrorStatusCodeException: Could not HEAD 'https://jitpack.io/com/github/smarteist/autoimageslider/1.4.0/autoimageslider-1.4.0.pom'. Received status code 401 from server: Unauthorized

已尝试的操作均无效：

• 切换离线模式
• 清除Gradle缓存、删除.gradle目录
• 更新Android Studio与Gradle版本
• 更换网络/VPN
• 切换Gradle JDK版本（1.8/11/19）
• 添加maven { url "https://jitpack.io" }和jcenter()仓库

可行解决方案 #

1. 确认Jitpack仓库配置位置 #

确保maven { url "https://jitpack.io" }添加在正确的位置：

• 旧版Gradle（项目根目录build.gradle）：

allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url "https://jitpack.io" }
    }
}

• Gradle 7.0+（settings.gradle）：

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven { url "https://jitpack.io" }
    }
}

不要只在app模块的build.gradle中配置，确保全局仓库列表包含Jitpack。

2. 处理Jitpack授权问题 #

401错误核心是请求未授权，分两种情况处理：

• 若依赖的是私有GitHub仓库：
  在项目根目录或全局~/.gradle/gradle.properties中添加GitHub凭证：

  github.username=你的GitHub账号名
  github.token=你的GitHub个人访问令牌（需开启read:packages权限）
  

  然后修改仓库配置引入凭证：

  maven {
      url "https://jitpack.io"
      credentials {
          username = project.findProperty("github.username") ?: System.getenv("GITHUB_USERNAME")
          password = project.findProperty("github.token") ?: System.getenv("GITHUB_TOKEN")
      }
  }
  

• 若依赖的是公开仓库：
  删除所有Jitpack相关的凭证配置，确保请求为匿名模式，避免不必要的授权校验。

3. 更换依赖版本或来源 #

检查该库的版本状态，尝试改用最新稳定版；若该库已发布到Maven Central，直接替换依赖坐标为Maven Central的版本（无需通过Jitpack拉取）。

4. 排查网络代理 #

如果使用了代理工具，关闭代理后重试，或确认代理未拦截Jitpack的HTTPS请求。

5. 强制刷新依赖缓存 #

执行以下Gradle命令彻底刷新依赖：

./gradlew clean build --refresh-dependencies

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