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

React Native模拟器无法安装并启动应用问题求助

嘿,新手朋友!解决React Native Android构建失败的小妙招

你刚入坑React Native就碰到react-native run-android的构建错误,确实挺闹心的。我帮你分析了下报错信息,核心问题是任务:app:transformClassesWithDexBuilderForDebug执行失败,无法读取指定路径的文件,大概率是缓存损坏、路径问题或者依赖异常导致的,试试下面这些方法,应该能搞定:

方法一:先清缓存,从头再来

缓存损坏是这类构建问题的头号元凶,先把旧缓存清干净:

  1. 打开终端,进入项目的android目录:
    cd android
    
  2. 执行Gradle清理命令:
    ./gradlew clean
    
  3. 回到项目根目录,重置React Native的缓存:
    npx react-native start --reset-cache
    
  4. 重新尝试构建项目:
    npx react-native run-android
    

方法二:检查项目路径,避开“坑”字符

我注意到你的项目路径里有空格(C:\Users\ruthel BAC\Desktop\firstAppReact),Android构建工具对带空格、特殊符号的路径兼容性很差,很容易出现文件读取失败的情况。建议你把整个项目移动到一个路径更简洁的文件夹下,比如C:\ReactNativeApps\firstAppReact,然后再重新执行构建命令。

方法三:重装依赖,确保库文件完整

有时候依赖下载不完整也会导致构建出错,试试重装依赖:

  1. 删除项目根目录下的node_modules文件夹和package-lock.json文件:
    rm -rf node_modules package-lock.json
    
  2. 重新安装所有依赖:
    npm install
    
  3. 再次运行Android项目:
    npx react-native run-android
    

方法四:开启MultiDex(进阶方案)

如果上面的方法都没用,可能是项目里的类文件太多超出了Android的单Dex限制,试试开启MultiDex:

  1. 打开android/app/build.gradle文件,找到defaultConfig块,添加一行配置:
    defaultConfig {
        // 其他原有配置...
        multiDexEnabled true
    }
    
  2. 同步Gradle后,重新执行构建命令。

按照这个顺序试下来,应该能解决你的问题啦!

内容的提问来源于stack exchange,提问作者BALOCK Ruthel C.A.

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.05.06 20:02:31