React Native项目降低minSdkVersion至22后编译失败：hermestooling库基于SDK24构建

阿华AIGC实验室

2026-4-2

问题原因分析

你遇到的核心问题是：你使用的React Native 0.81.1版本中，Hermes工具链（hermestooling）的预制分发库（通过Prefab机制）默认是针对minSdkVersion 24编译的。当你把项目的minSdk降到22后，CMake在匹配兼容库时，发现hermestooling的最低支持版本高于你的项目配置，因此抛出NoMatchingLibraryException。

另外需要注意：React Native 0.74及以上版本（包括你用的0.81.1）官方已将最低支持的minSdkVersion提升到24，直接降级到22会触发这类依赖库的版本不兼容问题。

解决方案

根据你的需求，这里提供几种可行的解决思路，你可以结合项目实际情况选择：

方案1：禁用Hermes引擎（快速无侵入）

如果你的项目可以接受不使用Hermes（Hermes是React Native默认的高性能JS引擎，禁用后会影响启动速度和运行性能），可以直接禁用它来绕过hermestooling的依赖：

打开android/app/build.gradle
在defaultConfig块中修改Hermes的启用状态：

defaultConfig {
    // 其他原有配置保持不变
    def enableHermes = false
}

或者仅在release构建中禁用（按需选择）：

buildTypes {
    release {
        // 其他原有配置保持不变
        enableHermes = false
    }
}

重新执行编译命令：

gradlew clean assembleRelease

方案2：修改Hermes预制库的版本兼容（保留Hermes，需补丁维护）

如果必须使用Hermes，可以手动修改hermestooling的Prefab元数据，让它支持minSdk22，同时用补丁工具确保修改不会被依赖安装覆盖：

打开node_modules/react-native/ReactAndroid/hermestooling/build/prefab/package.json
找到"minSdkVersion": 24这一行，将其修改为22
临时测试：直接执行gradlew clean assembleRelease，此时应该能正常编译
长期维护：使用patch-package生成补丁，避免每次npm install后修改被覆盖：
- 安装patch-package：
```
npm install patch-package --save-dev
```
- 生成补丁：
```
npx patch-package react-native
```
- 之后每次安装依赖，补丁会自动应用到node_modules中。