React Native Expo V49构建Android APK时出现未知错误求助

Build failed: Gradle build failed with unknown error. See logs for the "Run gradlew" phase for more information.

第一步：获取详细错误日志 #

这个报错只是笼统提示，必须查看"Run gradlew"阶段的完整日志才能定位问题：

• Android Studio环境：打开Build面板，切换到Gradle Console标签，查看完整构建输出；
• 命令行环境：执行./gradlew assembleDebug --stacktrace（Windows系统用gradlew.bat assembleDebug --stacktrace），通过--stacktrace参数获取错误栈详情。

常见问题对应修复方案 #

根据日志里的具体错误，匹配以下场景处理：

• 依赖版本冲突：日志出现Conflict with dependency类提示时，要么统一项目中相同依赖的版本，要么在build.gradle里用exclude排除冲突的子依赖；
• AGP与Gradle版本不兼容：数月未维护的项目易出现版本不匹配，打开根目录build.gradle，确保Android Gradle Plugin（AGP）和Gradle版本对应（比如AGP 7.4.x对应Gradle 7.5+）；
• 本地缓存损坏：执行./gradlew clean build --refresh-dependencies，清理旧缓存并重新下载所有依赖；
• SDK组件缺失：日志提示某SDK版本未安装时，打开SDK Manager下载对应版本的SDK Platform、Build Tools；
• 文件权限问题：Mac/Linux系统执行chmod -R 755 ./赋予项目目录读写权限；Windows系统右键项目目录，在“属性-安全”中确保当前用户有完全控制权限。

额外排查方向 #

• 检查第三方插件是否过期，比如旧版混淆、统计插件，更新到最新兼容版本；
• 确认本地JDK版本符合要求：AGP 7.0+需要JDK 11，可在Android Studio的File > Project Structure > SDK Location中指定对应JDK路径。

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