You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

求助:React Native项目无法在Android Studio模拟器启动(Windows10)

解决Windows 10下React Native启动Android项目提示路径找不到的问题

我之前也碰到过这个一模一样的问题,在Windows 10上折腾了好一阵才搞定,给你几个针对性的排查和解决步骤:

  • 检查Android SDK路径配置
    虽然你说环境配置好了,但还是要再确认下系统环境变量里的ANDROID_HOME或者ANDROID_SDK_ROOT是不是指向正确的SDK路径。比如默认路径一般是C:\Users\<你的用户名>\AppData\Local\Android\Sdk,要确保这个路径存在,而且环境变量里的拼写完全正确,没有多余的空格或者符号。

  • 验证React Native的Android路径配置
    打开项目根目录下的android/local.properties文件,检查里面的sdk.dir是不是和你的SDK路径一致。比如应该是:

    sdk.dir=C:\\Users\\<你的用户名>\\AppData\\Local\\Android\\Sdk
    

    注意Windows下路径要用双反斜杠转义,如果这个文件不存在,手动创建一个并写入正确路径。

  • 清理项目缓存后重启
    有时候缓存会导致路径识别异常,依次执行以下命令:

    # 清理npm缓存
    npm cache clean --force
    # 清理Android项目构建缓存
    cd android && gradlew clean
    cd ..
    # 重启Metro服务器
    npx react-native start --reset-cache
    

    然后再尝试启动项目:npx react-native run-android

  • 检查模拟器的ADB连接状态
    打开命令提示符,输入adb devices,看看你的模拟器是不是已经被识别到。如果没有显示,可能需要重启模拟器或者ADB服务:

    adb kill-server
    adb start-server
    

    确保模拟器处于运行状态,并且ADB能正常连接。

  • 检查Node.js和React Native版本兼容性
    有时候版本不兼容也会导致这类路径问题,确认你使用的React Native版本和Node.js版本是匹配的(比如React Native 0.7x推荐Node.js 16+)。可以通过node -v和npx react-native --version查看版本,必要时升级或降级到兼容版本。

提示:如果以上步骤都试过还是不行,可以试着手动打开Android Studio,导入项目的android文件夹,看看能不能正常构建运行。如果Android Studio能正常运行,那大概率是React Native的路径配置或者缓存问题;如果Android Studio也报错,那就要再检查SDK的组件是否安装完整(比如Android SDK Platform、Build Tools等)。

内容的提问来源于stack exchange,提问作者Maharoz Alam Mugdho

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.07 07:17:29