React Native 0.71.0项目Android模块Kotlin版本不兼容导致无法编辑问题求助

阿华AIGC实验室

2026-4-7

我之前踩过一模一样的版本兼容坑！核心问题是Gradle版本、AGP（Android Gradle Plugin）版本、Kotlin版本三者完全不匹配——你用了远高于AGP 7.3.1支持范围的Gradle 8.14.3，再加上缓存的Kotlin元数据版本冲突，光Invalidate Cache根本解决不了。下面是我亲测有效的修复步骤，完全基于不升级RN 0.71.0的前提：

一、先搞懂版本匹配逻辑（关键！）

React Native 0.71.0官方绑定的AGP版本是7.3.1，而AGP和Gradle有严格的版本绑定规则：

AGP 7.3.x 仅支持 Gradle 7.3 ~ 7.5 版本，绝对不能用8.x版本（你当前用的8.14.3就是冲突根源）
Kotlin版本需要和AGP、Gradle兼容，AGP 7.3.1完全支持Kotlin 1.7.x ~ 1.8.20 版本

二、具体修复步骤

1. 降级Gradle到兼容范围

打开项目根目录下的 gradle/wrapper/gradle-wrapper.properties，修改distributionUrl为AGP 7.3.1完美匹配的Gradle 7.5版本：

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

2. 调整Kotlin版本解决元数据冲突

打开android/build.gradle的buildscript块，把kotlin_version从1.7.20升级到1.8.0：

buildscript {
    ext {
        buildToolsVersion = "33.0.0"
        minSdkVersion = 23
        compileSdkVersion = 33
        targetSdkVersion = 33
        googlePlayServicesVersion = "17.0.0"
        firebaseMessagingVersion = "21.1.0"
        ndkVersion = "23.1.7779620"
        kotlin_version = '1.8.0' // 从1.7.20修改为1.8.0
    }
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath("com.android.tools.build:gradle:7.3.1")
        classpath("com.facebook.react:react-native-gradle-plugin")
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version")
        classpath 'com.google.gms:google-services:4.3.15'
        classpath 'com.google.firebase:firebase-crashlytics-gradle:2.9.9'
    }
}