React Native安卓构建失败：gradlew.bat命令执行出错求助

问题详情 #

• 系统环境：Windows 11，已安装Java SDK 22并配置好Java、Android环境变量
• 触发操作：克隆React Native项目后，执行yarn run android或adb reverse tcp:8081 tcp:8081 & set NODE_ENV=development & react-native run-android --list-devices --verbose
• 报错信息：

error Failed to build the app.
Error: Command failed with exit code 1: gradlew.bat app:installDebug -x lint -PreactNativeDevServerPort=8081
    at makeError (C:\Users\HUAWEI\WebstormProjects\Martines\application\client\node_modules\execa\lib\error.js:60:11)
    at module.exports.sync (C:\Users\HUAWEI\WebstormProjects\Martines\application\client\node_modules\execa\index.js:194:17)
    at build (C:\Users\HUAWEI\WebstormProjects\Martines\application\client\node_modules\@react-native-community\cli-platform-android\build\commands\buildAndroid\index.js:68:22)
    at runOnSpecificDevice (C:\Users\HUAWEI\WebstormProjects\Martines\application\client\node_modules\@react-native-community\cli-platform-android\build\commands\runAndroid\index.js:221:33)
    at buildAndRun (C:\Users\HUAWEI\WebstormProjects\Martines\application\client\node_modules\@react-native-community\cli-platform-android\build\commands\runAndroid\index.js:164:14)
    at process.processTicksAndRejections (node:internal/process/task_queues:95:5)
    at async Command.handleAction (C:\Users\HUAWEI\WebstormProjects\Martines\application\client\node_modules\@react-native-community\cli\build\index.js:118:9)
error Command failed with exit code 1.

• 已尝试：参考相关Stack Overflow方案，但问题未解决
• 项目settings.gradle配置：

rootProject.name = 'LesMartines'
apply from: file("../node_modules/@react-native-community/cli-platform-android/native_modules.gradle"); applyNativeModulesSettingsGradle(settings)
include ':app'
includeBuild('../node_modules/@react-native/gradle-plugin')

可行解决思路 #

• 降级Java版本：React Native多数稳定版本暂不支持Java 22，建议换成官方推荐的Java 17 LTS版本。卸载Java 22后安装Java 17，更新JAVA_HOME和系统环境变量，重启终端后重新执行构建命令。
• 查看详细构建日志：进入项目的android目录，执行gradlew.bat app:installDebug -x lint -PreactNativeDevServerPort=8081 --info，获取更具体的失败细节（比如依赖冲突、资源文件错误、SDK版本不匹配等），这是定位问题最直接的方式。
• 清理缓存与重新安装依赖：
  • 执行yarn cache clean清理yarn缓存
  • 删除项目根目录的node_modules文件夹，重新运行yarn install
  • 进入android目录，执行gradlew.bat clean清空构建缓存
• 核对Android SDK配置：确认已安装项目android/build.gradle中指定的compileSdkVersion、targetSdkVersion对应的SDK，同时检查SDK Build-Tools、NDK等组件版本是否匹配项目要求。
• 检查设备连接状态：执行adb devices确认真机/模拟器已正常连接，若用模拟器，尝试重启模拟器后再构建。
• 检查Manifest权限配置：查看android/app/src/main/AndroidManifest.xml中的权限声明是否完整，避免因权限缺失导致构建失败。

内容的提问来源于stack exchange，提问作者Thaïs