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

Flutter构建APK时MaterialIcons-Regular.otf字体加载失败问题求助

解决Flutter构建APK时MaterialIcons字体加载失败的问题

我之前也碰到过一模一样的坑,折腾了好一阵才搞定,给你几个亲测有效的方案,按顺序试试:

方案一:清除Flutter缓存并重新拉取字体

有时候就是缓存里的字体文件损坏了,直接清理缓存重新下载就行:

  1. 关掉所有Flutter相关的IDE和终端窗口
  2. 找到路径 C:\Users\[你的用户名]\flutter\bin\cache\artifacts\material_fonts,删掉这个文件夹里的所有文件
  3. 打开终端跑 flutter doctor,它会自动重新下载缺失的MaterialIcons字体
  4. 再尝试执行 flutter build apk

方案二:手动替换MaterialIcons字体文件

如果自动下载的字体还是有问题,可以手动替换:

  1. 从Google官方的Material Icons资源里下载最新的MaterialIcons-Regular.otf文件
  2. 把下载好的文件替换到 C:\Users\[你的用户名]\flutter\bin\cache\artifacts\material_fonts 目录下
  3. 确认当前用户对这个文件有读写权限(右键文件→属性→安全,检查权限设置)
  4. 重新执行构建命令

方案三:升级Flutter和Gradle版本

老版本的Flutter或者Gradle可能和Harfbuzz存在兼容性问题:

  1. 终端跑 flutter upgrade 升级到最新的稳定版Flutter
  2. 打开项目的 android/build.gradle 文件,把Gradle的版本升级到Flutter官方推荐的稳定版
  3. 同步项目后再尝试构建

方案四:检查本地权限和拦截软件

有时候是本地权限或者杀毒软件搞的鬼:

  1. 确保当前用户对 C:\Users\[你的用户名]\flutter\bin\cache 目录有完全控制的权限
  2. 临时关闭杀毒软件、防火墙之类的工具,看看是不是它们拦截了字体文件的读取
  3. 清理项目的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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.04.27 20:52:42