Android Gradle Plugin版本异常：指定7.2.1却提示7.3.1不兼容

• 子模块独立配置了AGP版本：如果是多模块项目，检查所有子模块的build.gradle文件，确认是否有子模块单独指定了com.android.tools.build:gradle:7.3.1，或是子模块的buildscript块覆盖了根项目的配置。

• Gradle缓存残留：常规clean操作可能无法彻底清除旧版本AGP缓存，需执行以下步骤：

  1. 关闭Android Studio
  2. 删除本地Gradle缓存目录：
     • macOS/Linux：~/.gradle/caches
     • Windows：C:\Users\<你的用户名>\.gradle\caches
  3. 重启AS后重新同步项目
     也可通过AS内置功能清理：File > Invalidate Caches...，勾选Clear file system cache and local history后点击Invalidate and Restart

• 第三方插件传递依赖引入高版本AGP：部分第三方插件（如打包、代码检查、测试类插件）可能依赖AGP 7.3.1，导致间接引入。执行以下命令查看完整依赖树，定位AGP 7.3.1的来源：

  ./gradlew buildEnvironment
  

  在输出中搜索com.android.tools.build:gradle，找到带有7.3.1的依赖项，之后针对该插件调整版本或排除传递依赖。

• Android Studio插件配置冲突：尽管项目结构显示7.2.1，仍需检查AS全局Gradle配置：Settings > Build, Execution, Deployment > Build Tools > Gradle，确认Android Gradle Plugin Version是否设置为7.2.1，避免AS自动使用不兼容版本。

• Gradle版本与AGP不匹配：AGP 7.2.1对应的兼容Gradle版本范围是7.3至7.5，你当前使用的Gradle 7.6.2超出了兼容范围，可能引发版本检测异常。建议将Gradle版本降级到7.5，修改gradle/wrapper/gradle-wrapper.properties中的distributionUrl：

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

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