Gradle下载旧版react-native触发createJSModules报错如何解决

报错信息为：

ReactNativeBiometricsPackage is not abstract and does not override abstract method createJSModules()

该报错本质是项目中依赖的react-native-biometrics版本过旧，仅适配RN 0.47及更早版本，同时Gradle拉取了不匹配的旧版RN依赖导致，可按以下步骤逐一排查解决：

• 方法1：升级生物识别库到兼容版本
  1. 卸载旧版本库：
     npm uninstall react-native-biometrics 或 yarn remove react-native-biometrics
  2. 安装适配RN 0.60+的2.0.0及以上版本：
     npm install react-native-biometrics@latest 或 yarn add react-native-biometrics@latest
  3. 删除项目根目录的node_modules、package-lock.json/yarn.lock文件，重新执行npm install或yarn install安装依赖
• 方法2：Gradle强制锁定RN版本，避免子依赖拉取旧版
  在android/build.gradle文件的allprojects代码块中添加版本强制策略，配置如下：

  allprojects {
      configurations.all {
          resolutionStrategy {
              // 替换为你项目实际使用的RN完整版本号，比如0.63.0、0.63.4
              force "com.facebook.react:react-native:0.63.4"
          }
      }
      repositories {
          // 原有仓库配置保持不变，必须保留node_modules对应的本地maven地址
          maven { url "$rootDir/../node_modules/react-native/android" }
          mavenLocal()
          jcenter()
      }
  }
  

  配置完成后清空Gradle缓存：
  1. 进入android目录：cd android
  2. Windows执行gradlew cleanBuildCache，Mac/Linux执行./gradlew cleanBuildCache
  3. 删除android目录下的.gradle文件夹，再重新运行react-native run android
• 方法3：清理冗余手动链接与全量缓存
  若之前手动link过旧版的生物识别库，先执行react-native unlink react-native-biometrics移除手动配置，再执行npx react-native clean一键清理Metro、Gradle、依赖等所有缓存，重装依赖后重试。
• 方法4：临时兼容（不推荐，仅用于紧急修复）
  若确实无法升级依赖库，可手动修改node_modules/react-native-biometrics/android/src/main/java/[包路径]/ReactNativeBiometricsPackage.java文件，在类中添加空实现的createJSModules方法：

  @Override
  public List<Class<? extends JavaScriptModule>> createJSModules() {
      return Collections.emptyList();
  }
  

  后续可通过patch-package工具保存该修改，避免重装依赖后配置丢失。

内容的提问来源于stack exchange，提问作者Ariel