Flutter中AssetImage加载失败但图片实际存在的问题排查

核心原因 #

• 资源未在pubspec.yaml中注册：Flutter不会自动扫描lib目录下的资源文件，必须在项目的pubspec.yaml中显式声明要打包的资源，否则运行时无法找到对应图片。
• Asset路径写法错误：使用Image.asset()时，路径不需要包含lib/前缀。Flutter的资源路径是基于pubspec.yaml中配置的路径映射，而非直接的文件系统全路径。

具体解决步骤 #

1. 配置pubspec.yaml
   在flutter节点下添加assets配置，注意缩进要和同级属性（如uses-material-design）保持一致：

   flutter:
     uses-material-design: true
     assets:
       - lib/images/logo.png
       # 若需加载整个images目录下的所有资源，可简化为：
       # - lib/images/
   

2. 修正Image.asset的路径
   移除路径中的lib/前缀，修改后的代码如下：

   Image.asset(
     'images/logo.png',
     width: 180,
   ),
   

补充说明 #

配置完pubspec.yaml后，建议重启Flutter应用或执行flutter pub get命令，确保资源被正确打包到应用中。

内容的提问来源于stack exchange，提问作者Cliff Odebala Clarke