React Native安卓模拟器运行报错：Kotlin编译失败

算力阿峰

2026-6-15

解决React Native Kotlin编译错误（Unresolved reference: files）

这个错误源于Gradle/Kotlin版本与React Native的gradle-plugin不兼容，试试以下几种解决办法：

检查Gradle版本兼容性
React Native不同版本对Gradle有明确要求，比如RN 0.72及以上需要Gradle 7.5+。打开项目根目录下的gradle/wrapper/gradle-wrapper.properties，确认distributionUrl指向符合要求的版本，示例：
```
distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip
```

清理缓存并重装依赖
执行以下命令彻底清理缓存和依赖，重新构建项目：

rm -rf node_modules
rm package-lock.json yarn.lock
npm install
cd android && ./gradlew clean
cd ..

匹配Kotlin插件版本
打开android/build.gradle文件，确保Kotlin插件版本和当前React Native版本匹配。比如RN 0.72+对应Kotlin 1.8.0，修改buildscript里的依赖：
```
buildscript {
    dependencies {
        // 确保版本和RN要求一致
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.8.0"
    }
}
```
临时修复报错文件（不推荐长期使用）
找到报错的文件node_modules/@react-native/gradle-plugin/settings-plugin/src/main/kotlin/com/facebook/react/ReactSettingsExtension.kt，在文件顶部添加导入语句：
```
import org.gradle.api.Project
```
然后把第43行的files改成project.files。注意这个修改会在下次npm install后被覆盖，优先采用前面的版本兼容方案。