React Native构建Android时无法评估'android'配置的求助

问题背景 #

使用npx react-native init AnAppName创建全新React Native项目，在Android Studio Koala（2024版）中运行npx react-native run-android时，抛出以下错误：

ERROR: autolinkLibrariesFromCommand: process cmd /c npx @react-native-community/cli config exited with error code: 1
FAILURE: Build failed with an exception.

• Where:
  Settings file 'C:\Users\USER NAME\reactNativeProjects\aaaandanotherproject\android\settings.gradle' line: 3
• What went wrong:
  A problem occurred evaluating settings 'android'.

ERROR: autolinkLibrariesFromCommand: process cmd /c npx @react-native-community/cli config exited with error code: 1

项目未修改任何代码，默认的settings.gradle内容如下：

pluginManagement { includeBuild("../node_modules/@react-native/gradle-plugin") }
plugins { id("com.facebook.react.settings") }
extensions.configure(com.facebook.react.ReactSettingsExtension){ ex ->     ex.autolinkLibrariesFromCommand() }
rootProject.name = 'aaaandanotherproject'
include ':app'
includeBuild('../node_modules/@react-native/gradle-plugin')

删除第三行extensions.configure(...)后，又出现新错误：:app未初始化。

解决方案 #

1. 检查Node.js版本与环境权限 #

• 确认Node.js为React Native兼容的LTS版本（如20.x），运行node -v查看版本，不符合则升级。
• 关闭Android Studio后，用管理员权限打开终端，进入项目根目录执行命令，避免权限限制导致的CLI调用失败。
• 验证npm可正常调用，运行npm -v确认输出版本号。

2. 修复settings.gradle配置 #

不要直接删除第三行，改为手动配置自动链接逻辑，确保:app模块正常初始化：
修改settings.gradle为以下内容：

pluginManagement {
    includeBuild("../node_modules/@react-native/gradle-plugin")
}

plugins {
    id("com.facebook.react.settings") version "0.74.0" // 替换为你项目中@react-native/gradle-plugin的实际版本
}

extensions.configure(com.facebook.react.ReactSettingsExtension) { ex ->
    ex.autolinkLibraries = true
    ex.rootProjectName = rootProject.name
}

rootProject.name = 'aaaandanotherproject'
include ':app'
includeBuild('../node_modules/@react-native/gradle-plugin')

3. 清理缓存并重新构建 #

• 清理React Native缓存：

  npx react-native clean
  

• 清理Android Gradle缓存：

  cd android
  ./gradlew clean
  

• 回到项目根目录重装依赖：

  npm install
  

• 重新运行项目：

  npx react-native run-android
  

4. 核对Gradle与JDK配置 #

• 确认Android Studio使用JDK 17：打开File > Project Structure > SDK Location，检查JDK路径是否指向正确版本。
• 同步Gradle版本：参考node_modules/react-native/gradle/wrapper/gradle-wrapper.properties中的distributionUrl，修改项目根目录gradle/wrapper/gradle-wrapper.properties对应内容，确保版本兼容。

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