导入React Native安卓目录到Android Studio报插件版本错误怎么解决

该报错是项目依赖的Android Gradle Plugin (AGP) 版本高于当前Android Studio内置支持的最高AGP版本导致的，此前操作正常现在触发报错，通常是你近期执行过RN版本升级、项目依赖更新操作，拉高了AGP版本，旧版Android Studio不再适配。

方案1：升级Android Studio（推荐，长期适配） #

• 打开Android Studio，点击顶部菜单栏 File > Settings > Appearance & Behavior > System Settings > Updates
• 检查并安装最新稳定版Android Studio，升级完成后重启IDE重新导入项目即可
• 升级前可备份本地全局Gradle自定义配置，避免配置被覆盖

方案2：降级项目AGP版本（临时适配，无需修改IDE） #

如果你暂时不想升级Android Studio，可手动下调项目AGP版本到当前IDE支持的范围：

1. 打开RN项目android目录下的根 build.gradle 文件，找到com.android.tools.build:gradle依赖项，将版本号降到4.2.*及以下，示例修改如下：

dependencies {
    classpath "com.android.tools.build:gradle:4.2.2"
    // 其余依赖保持原有配置不变
}

2. 打开 gradle/wrapper/gradle-wrapper.properties 文件，调整Gradle发行版版本为和AGP 4.2匹配的版本，示例如下：

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

3. 清理项目缓存后重新构建：
   • 进入项目android目录，执行命令 ./gradlew clean（Windows系统执行 gradlew clean）
   • 重启Android Studio重新导入项目即可

异常排查 #

如果修改后仍提示报错，可清除IDE缓存后重试：

• 点击Android Studio顶部菜单 File > Invalidate Caches...
• 勾选 Clear file system cache and local history 后点击Invalidate and Restart，重启后即可正常加载项目

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