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

Flutter使用AssetImage加载图片抛出Unable to load asset异常求助

Flutter Unable to load asset 异常排查方案
  • 校验目录与文件真实性
    确认项目根目录下存在images文件夹,且diamond.png确实存放在该目录下,无文件损坏、无嵌套子目录。特别注意大小写问题:移动端操作系统大小写敏感,若文件实际名为Diamond.png或diamond.PNG,和代码引用的images/diamond.png不匹配也会触发报错。
  • 校验pubspec.yaml资源声明
    即使你确认缩进符合规范,再核对如下配置格式:
flutter:
  uses-material-design: true
  # assets项相对于flutter层级缩进2空格,资源路径相对于assets层级再缩进2空格
  assets:
    - images/diamond.png
    # 如需批量导入整个images目录的资源,可直接写 - images/

不要漏写路径前的短横线,也不要在路径前加多余的斜杠。

  • 校验代码路径一致性
    确认代码中AssetImage('images/diamond.png')的路径拼写和pubspec.yaml中声明的路径完全一致,无拼写错误、多余斜杠或漏写层级。
  • 刷新资源缓存
    修改完资源配置后,先执行flutter clean清理项目缓存,再执行flutter pub get重新加载资源,之后完全重启应用(不要使用热重载/热重启,这两种操作不会更新资源配置)。
  • 多环境配置校验
    如果你的项目配置了多flavor、多打包环境,需要确认对应环境的资源声明中也包含了该图片路径。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.02 05:48:03