React Native 0.76.5构建报错：generateAutolinkingNewArchitectureFiles任务失败

核心排查与修复步骤 #

1. 校验新架构配置 #

• 确认是否意外开启新架构：React Native 0.76 默认使用旧架构，第三方库可能触发新架构检测导致冲突。检查 android/gradle.properties 中以下参数，确保为 false：

  newArchEnabled=false
  

• 若需启用新架构，同步 Gradle 版本：Gradle 8.7 对应 Android Gradle Plugin (AGP) 应为 8.7.x，当前 classpath 7.4.2 版本不匹配会引发文件生成异常。修改 android/build.gradle 中的 classpath：

  classpath("com.android.tools.build:gradle:8.7.0")
  

2. 修复 React Native Document Picker 适配 #

• 安装适配 RN 0.76 的库版本：执行命令重新安装最新稳定版（适配 RN 0.70+）：

  npm uninstall react-native-document-picker
  npm install react-native-document-picker@latest
  

• 强制触发 autolink 同步：

  npx react-native autolink
  

3. 彻底清理 Gradle 缓存 #

• 删除本地及项目缓存：

  ./gradlew clean
  rm -rf ~/.gradle/caches
  rm -rf android/.gradle
  rm -rf android/app/build
  

• 重新初始化 Gradle 依赖：

  cd android && ./gradlew build --refresh-dependencies
  

4. 检查项目文件完整性 #

• 手动创建缺失的 autolink 目录：若 android/app/build/generated/autolinking 不存在，执行以下命令创建后重新构建：

  mkdir -p android/app/build/generated/autolinking
  

• 排查 react-native.config.js 配置：若文件存在，确保未禁止 Document Picker 的 autolink，删除类似以下错误配置：

  module.exports = {
    dependencies: {
      'react-native-document-picker': {
        platforms: {
          android: null, // 删除此行
        },
      },
    },
  };
  

若以上方案无效，需补充的信息 #

• generateAutolinkingNewArchitectureFiles 任务的完整错误堆栈日志
• package.json 中所有依赖的版本列表
• android/gradle.properties 和 android/build.gradle 的完整配置内容

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