Flutter聊天应用界面用户照片无法加载问题求助

问题概述 #

在制作Flutter聊天应用UI时，已在pubspec.yaml中正确声明本地图片资源，且用户模型参数配置无误，但界面中的用户头像始终无法显示。

核心错误原因 #

在conversation_list.dart的CircleAvatar组件中，错误使用了NetworkImage加载本地资源，而本地图片资源应该使用AssetImage。

修改步骤 #

1. 打开conversation_list.dart文件，找到CircleAvatar的代码块：

CircleAvatar(
  backgroundImage: NetworkImage(widget.imageUrl),
  maxRadius: 30,
),

2. 将NetworkImage替换为AssetImage：

CircleAvatar(
  backgroundImage: AssetImage(widget.imageUrl),
  maxRadius: 30,
),

额外验证与优化 #

• 确保本地图片文件存放在项目根目录的images文件夹下，文件名和路径完全匹配（跨平台环境下文件名大小写敏感）
• 修改pubspec.yaml后执行flutter pub get刷新资源，然后重启应用（热重载可能无法生效资源配置变更）
• 可简化pubspec.yaml中的资源声明，用通配符替代逐个列出的图片路径：

assets:
  - images/

内容的提问来源于stack exchange，提问作者Gybernaty