安装react-native-ble-plx后React Native项目构建失败求助

DevOps 小满

2026-6-30

React Native react-native-ble-plx Android构建错误解决方案

这个错误核心是JDK 21与Android SDK 34、react-native-ble-plx的兼容性问题，jlink工具执行失败导致无法生成JDK镜像文件。以下是可行的解决步骤：

降级JDK到17版本
Android Gradle插件对JDK 17的支持更稳定，和Android 34适配性更好。卸载当前的JDK 21，安装OpenJDK 17或Oracle JDK 17，然后配置系统环境变量JAVA_HOME指向JDK 17的安装路径，最后在命令行输入java -version确认版本切换成功。
清理Gradle缓存
删除项目根目录下的.gradle文件夹、android/.gradle文件夹，然后在项目的android目录下执行gradlew clean（Windows）或./gradlew clean（macOS/Linux），彻底清除旧的构建缓存。
对齐Android Gradle插件版本
打开项目的android/build.gradle文件，确保buildscript下的Android Gradle插件版本和SDK 34兼容，比如设置为7.4.2及以上：
```
buildscript {
    dependencies {
        classpath("com.android.tools.build:gradle:7.4.2")
        // 其他依赖...
    }
}
```

强制子模块使用JDK 17编译
在android/build.gradle的末尾添加以下配置，让react-native-ble-plx模块使用JDK 17编译：

subprojects {
    afterEvaluate { project ->
        if (project.hasProperty('android')) {
            android {
                compileOptions {
                    sourceCompatibility JavaVersion.VERSION_17
                    targetCompatibility JavaVersion.VERSION_17
                }
            }
        }
    }
}