Flutter构建APK时MaterialIcons-Regular.otf字体加载失败问题求助
解决Flutter构建APK时MaterialIcons字体加载失败的问题
我之前也碰到过一模一样的坑,折腾了好一阵才搞定,给你几个亲测有效的方案,按顺序试试:
方案一:清除Flutter缓存并重新拉取字体
有时候就是缓存里的字体文件损坏了,直接清理缓存重新下载就行:
- 关掉所有Flutter相关的IDE和终端窗口
- 找到路径
C:\Users\[你的用户名]\flutter\bin\cache\artifacts\material_fonts,删掉这个文件夹里的所有文件 - 打开终端跑
flutter doctor,它会自动重新下载缺失的MaterialIcons字体 - 再尝试执行
flutter build apk
方案二:手动替换MaterialIcons字体文件
如果自动下载的字体还是有问题,可以手动替换:
- 从Google官方的Material Icons资源里下载最新的
MaterialIcons-Regular.otf文件 - 把下载好的文件替换到
C:\Users\[你的用户名]\flutter\bin\cache\artifacts\material_fonts目录下 - 确认当前用户对这个文件有读写权限(右键文件→属性→安全,检查权限设置)
- 重新执行构建命令
方案三:升级Flutter和Gradle版本
老版本的Flutter或者Gradle可能和Harfbuzz存在兼容性问题:
- 终端跑
flutter upgrade升级到最新的稳定版Flutter - 打开项目的
android/build.gradle文件,把Gradle的版本升级到Flutter官方推荐的稳定版 - 同步项目后再尝试构建
方案四:检查本地权限和拦截软件
有时候是本地权限或者杀毒软件搞的鬼:
- 确保当前用户对
C:\Users\[你的用户名]\flutter\bin\cache目录有完全控制的权限 - 临时关闭杀毒软件、防火墙之类的工具,看看是不是它们拦截了字体文件的读取
- 清理项目的Gradle缓存:删掉项目里的
android/.gradle文件夹,然后跑flutter clean,再重新构建
问题场景还原
我尝试构建APK时遇到以下错误:无法加载输入字体C:\Users....\flutter\bin\cache\artifacts\material_fonts\MaterialIcons-Regular.otf;终止执行。该错误表明字体无效,或者当前版本的Harfbuzz无法处理它。我已查阅过往相关解决方案,但遗憾的是均未奏效。
FAILURE: 构建因异常而失败。
- 位置: 脚本'C:\Users.....\flutter\packages\flutter_tools\gradle\flutter.gradle'第1156行
- 出错原因: 任务':app:compileFlutterBuildRelease'执行失败。
进程'命令'C:\Users...\flutter\bin\flutter.bat''以非零退出值1结束
- 建议操作:
使用--stacktrace选项获取堆栈跟踪信息。
使用--info或--debug选项获取更多日志输出。
使用--scan选项获取完整分析信息。
- 获取更多帮助: https://help.gradle.org
BUILD FAILED in 1m 28s
正在运行Gradle任务'assembleRelease'... 91.1s
Gradle任务assembleRelease以退出代码1失败
内容的提问来源于stack exchange,提问作者Toxic Axes
相关产品推荐
相关产品推荐

