构建React Native原生项目遇Kotlin实验性API报错求助

数据老陈

2026-8-13

解决React Native构建时ExperimentalStdlibApi报错问题

遇到的报错：

e: /Users/abc/update/node_modules/react-native-gradle-plugin/src/main/kotlin/com/facebook/react/TaskConfiguration.kt: (29, 33): 此声明为实验性内容，其使用必须标记为'@kotlin.ExperimentalStdlibApi' 或 '@OptIn(kotlin.ExperimentalStdlibApi::class)'

试试这些解决方法：

方法1：直接修改报错的插件文件

找到路径 /Users/abc/update/node_modules/react-native-gradle-plugin/src/main/kotlin/com/facebook/react/TaskConfiguration.kt 并打开：

在文件最顶部加一行注解：@file:OptIn(kotlin.ExperimentalStdlibApi::class)
或者在第29行附近的报错声明（函数/类）上方单独加 @OptIn(kotlin.ExperimentalStdlibApi::class)

保存文件后重新执行构建命令即可。

方法2：升级React Native版本

这个报错大多是RN插件与Kotlin版本不兼容导致的，升级到0.72及以上的RN稳定版，官方已经修复了这类适配问题。执行升级命令：

npx react-native upgrade

也可以根据官方文档指定具体版本升级。

方法3：全局配置Gradle启用OptIn

在项目根目录的 android/build.gradle 文件中添加全局编译参数：

buildscript {
    ext {
        kotlinVersion = "1.8.20" // 确保版本和RN插件兼容，建议1.8.x以上
    }
    dependencies {
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlinVersion"
    }
}

allprojects {
    tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile).configureEach {
        kotlinOptions {
            freeCompilerArgs += ["-opt-in=kotlin.ExperimentalStdlibApi"]
        }
    }
}

同步Gradle后重新构建项目。