Gradle依赖解析监听器通知失败问题求助

报错信息：

Failed to notify dependency resolution listener. 'void org.gradle.api.artifacts.DependencySubstitutions$Substitution.with(org.gradle.api.artifacts.component.ComponentSelector)'

核心问题分析 #

配置存在Android Gradle Plugin（AGP）与Gradle版本严重不兼容的问题，同时伴随仓库废弃、无效依赖、混合新旧支持库等问题，导致依赖解析流程崩溃。

具体解决步骤 #

• 匹配AGP与Gradle版本
  AGP 4.1.3仅支持Gradle 6.5-6.7版本，当前使用的Gradle 8.9属于高版本完全不兼容，二选一修复：
  方案1：降级Gradle到兼容版本
  修改gradle/wrapper/gradle-wrapper.properties中的distributionUrl：

  distributionUrl=https\://services.gradle.org/distributions/gradle-6.7-bin.zip
  

  方案2：升级AGP到兼容Gradle 8.9的版本（推荐，规避旧版本安全漏洞）
  修改根目录build.gradle：

  buildscript {
      repositories {
          google()
          mavenCentral() // 替换已废弃的jcenter()
      }
      dependencies {
          classpath "com.android.tools.build:gradle:8.5.0" // 兼容Gradle8.9的AGP版本
          classpath 'com.google.gms:google-services:4.4.1' // 匹配AGP的google-services版本
      }
  }
  
  allprojects {
      repositories {
          google()
          mavenCentral() // 替换jcenter()
      }
  }
  

• 清理无效依赖
  移除不存在的示例依赖：

  // implementation("com.example.library:library-a:1.2.3") // 删除此行
  

• 统一AndroidX依赖
  移除旧版support库，替换为AndroidX版本：

  // 移除以下两行
  // implementation "com.android.support:support-annotations:28.0.0"
  // annotationProcessor "com.android.support:support-annotations:28.0.0"
  // 添加AndroidX注解依赖
  implementation 'androidx.annotation:annotation:1.6.0'
  

• 升级冲突依赖
  部分旧依赖可能与新版本AGP/Gradle冲突，建议升级到稳定兼容版本：

  implementation 'com.github.bumptech.glide:glide:4.16.0'
  annotationProcessor 'com.github.bumptech.glide:compiler:4.16.0'
  implementation 'androidx.navigation:navigation-fragment:2.7.5'
  implementation 'androidx.navigation:navigation-ui:2.7.5'
  

验证修复 #

1. 执行File -> Invalidate Caches... -> Invalidate and Restart重启Android Studio
2. 点击Sync Project with Gradle Files同步项目

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