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
相关产品推荐
相关产品推荐

