Unity导出Android时Gradle build failed问题求助(仅当前项目报错)
Unity导出Android Gradle构建失败(仅当前项目)的排查方案
- 检查项目Android专属配置
- 打开
Player Settings > Android,对比正常项目逐一核对:- 确认
Package Name符合反向域名规则(无大写、特殊字符) - 同步
Minimum API Level、Target API Level与正常项目一致,避免API版本不匹配 - 若开启
Custom Gradle Template,检查mainTemplate.gradle、launcherTemplate.gradle中的依赖、插件版本,排查是否存在无效依赖或版本冲突
- 确认
- 打开
- 清理项目缓存与构建文件
- 删除项目根目录下的
Library、Temp、Obj文件夹,重启Unity后重新尝试构建 - 若导出Android项目,手动删除项目内的
gradle、.gradle、build目录,再通过本地Gradle执行构建,获取更精准的错误信息
- 删除项目根目录下的
- 排查第三方插件冲突
- 逐个禁用当前项目新增的第三方插件(如广告、支付SDK),重新导出定位问题插件
- 检查
Assets/Plugins/Android目录下的aar、jar文件,以及插件自带的AndroidManifest.xml,排查重复权限、重复依赖等问题
- 检查资源文件合规性
- 排查项目中是否存在命名不符合Android规范的资源(如含中文、空格、特殊字符的文件名),这类资源易触发打包错误
- 验证
Assets/Plugins/Android下的aar、jar文件是否损坏,尝试移除后重新导入
- 查看完整错误日志
- 在Unity Console面板切换到
Error级别,查看Gradle构建的完整报错详情 - 导出Android项目后用Android Studio打开,通过
Build面板获取具体错误点(如依赖冲突、清单文件语法错误)
- 在Unity Console面板切换到
内容的提问来源于stack exchange,提问作者مریم ناظمی
相关产品推荐
相关产品推荐

