React Native新项目启动失败：无法找到Android SDK位置

错误详情 #

启动React Native新项目时触发如下错误：

无法确定任务':app:compileDebugJavaWithJavac'的依赖项。
未找到SDK位置。请通过ANDROID_SDK_ROOT环境变量定义位置，或在项目的本地配置文件'/home/mobii/android/local.properties'中设置sdk.dir路径。

BUILD FAILED in 2s

报错堆栈信息：

at makeError (/home/mobii/node_modules/@react-native-community/cli-platform-android/node_modules/execa/index.js:174:9)
at /home/mobii/node_modules/@react-native-community/cli-platform-android/node_modules/execa/index.js:278:16
at processTicksAndRejections (node:internal/process/task_queues:96:5)
at async runOnAllDevices (/home/mobii/node_modules/@react-native-community/cli-platform-android/build/commands/runAndroid/runOnAllDevices.js:109:5)
at async Command.handleAction (/home/mobii/node_modules/@react-native-community/cli/build/index.js:192:9)

解决方法 #

方式1：配置ANDROID_SDK_ROOT环境变量 #

• 临时生效（仅当前终端会话）：

  export ANDROID_SDK_ROOT=/你的Android SDK实际路径
  

• 永久生效（根据终端类型配置）：
  • Bash终端：编辑~/.bashrc文件，添加上述export命令，执行source ~/.bashrc使配置生效
  • Zsh终端：编辑~/.zshrc文件，添加上述export命令，执行source ~/.zshrc使配置生效

方式2：修改项目local.properties文件 #

1. 进入项目android目录：cd /home/mobii/android
2. 创建或编辑local.properties文件，添加以下内容（替换为你的SDK实际路径）：

   sdk.dir=/home/你的用户名/Android/Sdk
   

额外调试建议 #

• 执行启动命令时添加--stacktrace参数获取详细堆栈跟踪
• 添加--info或--debug参数查看更多日志输出
• 添加--scan参数获取完整分析信息

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