React Native安卓项目构建/清理时卡在98%，求解决方案

排查与解决步骤 #

• 查看Gradle详细日志
  执行命令时添加--info参数，比如react-native run-android --info，或者直接在Android Studio中打开项目，点击Build > Make Project查看Build窗口的日志输出，找到卡在98%时正在执行的具体任务——多数情况是依赖下载或某个编译子任务停滞，日志会给出明确线索。

• 清理Gradle缓存与本地构建文件

  1. 删除项目根目录下的.gradle文件夹，以及Android模块下的.gradle和build文件夹
  2. 执行gradlew clean build --refresh-dependencies命令，强制刷新依赖并重新构建

• 调整Gradle堆内存配置
  在项目的gradle.properties文件中，修改或添加以下配置，增大Gradle可用内存：

  org.gradle.jvmargs=-Xmx4096m -XX:MaxPermSize=512m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8
  

  内存不足是大项目构建停滞的常见原因。

• 检查Android SDK组件完整性
  打开Android Studio的SDK Manager，确认已安装项目对应版本的Android SDK、Build Tools，以及Google Repository、Android Support Repository等必要组件，缺失组件会导致构建后期无法完成。

• 临时关闭防火墙/代理
  若之前配置过代理，或防火墙拦截了Gradle的依赖下载请求，可能导致任务卡住。临时关闭防火墙，或在gradle.properties中移除代理相关配置后重试。

• 更换兼容的Gradle版本
  查看项目根目录gradle/wrapper/gradle-wrapper.properties文件，修改distributionUrl为与当前React Native版本兼容的稳定Gradle版本，比如：

  distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-all.zip
  

  版本不匹配易引发构建异常。

内容的提问来源于stack exchange，提问作者Ahmet Tarık Bostan