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

Unity导出程序时找不到mainTemplate.gradle文件报错如何修复

问题现象

Unity 2021.3.6f1版本导出Android平台安装包时流程中断,抛出文件找不到异常,具体报错信息如下:

FileNotFoundException: Failed to find C:/Program Files/Unity/Hub/Editor/2021.3.6f1/Editor/Data/PlaybackEngines/AndroidPlayer/Tools/GradleTemplates/mainTemplate.gradle
UnityEditor.Android.AndroidBuildPostprocessor.GetTemplate (System.String toolsPath, System.String fileName) (at <0bc7e9c04c1540528b26863a0cb726ae>)

注:报错路径开头的$、正反斜杠混用是Unity路径拼接逻辑的显示问题,不影响实际定位

修复方法

按优先级依次尝试以下操作即可解决:

  • 补装/修复Android构建组件
    打开Unity Hub,找到已安装的2021.3.6f1版本,点击版本右侧菜单选择「添加模块」,展开「Android Build Support」项,确认Android SDK & NDK Tools、OpenJDK两个子项均已勾选安装。如果已经显示安装,先取消勾选完成卸载,再重新勾选执行安装,修复组件安装过程中出现的文件丢失、损坏问题。
  • 校验目标路径文件完整性
    打开报错提示的对应目录C:/Program Files/Unity/Hub/Editor/2021.3.6f1/Editor/Data/PlaybackEngines/AndroidPlayer/Tools/GradleTemplates,检查目录下是否存在mainTemplate.gradle文件。如果文件缺失,优先通过上一步的重装组件修复,也可以从同版本正常运行的Unity安装路径中拷贝完整的GradleTemplates文件夹覆盖到对应目录。操作前需要完全关闭Unity编辑器。
  • 排查自定义Gradle配置冲突
    打开Unity项目,依次进入Edit > Project Settings > Player > Android平台 > Publishing Settings,找到Build分类下的Custom Main Gradle Template选项,先取消勾选后尝试重新导出。如果项目必须使用自定义Gradle配置,取消勾选后重新勾选该选项,让Unity重新生成默认的mainTemplate.gradle文件,同时检查项目路径、Assets/Plugins/Android目录下的自定义模板文件是否存在中文、特殊字符或损坏问题。
  • 解决系统目录权限限制
    如果上述操作后仍报错,右键Unity Hub图标选择「以管理员身份运行」,重新打开项目执行导出。也可以将Unity编辑器安装到非系统盘的非受保护目录(比如D:/Unity/Editor路径下),规避Windows系统对Program Files目录的读写权限限制。

内容的提问来源于stack exchange,提问作者Josef Werkmeister

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.27 02:27:21