Flutter中Firebase通知图片无法显示的问题排查

核心原因：FCM Payload 结构配置错误 #

你当前把图片URL放在data字段中，但FCM的通知栏自动渲染图片需要将图片配置在notification字段内。data字段的内容需要客户端手动解析处理，不会被FCM自动展示到通知栏。

修复后的Payload代码 #

修改payload部分，将image字段移至notification下：

Map<String, dynamic> payload = {
  'notification': {
    'title': title,
    'body': description,
    'image': imageUrl, // 移到此处让FCM自动处理图片展示
  },
  'data': {
    // 保留需要客户端额外逻辑处理的数据（可选）
  },
  'to': token,
};

其他需排查的点 #

• 图片URL必须为HTTPS协议：FCM不支持HTTP链接，确保imageUrl以https://开头。
• 图片可访问性验证：直接在浏览器打开图片URL，确认没有防盗链、登录权限等限制。
• 图片规格符合要求：建议图片比例为2:1，文件大小不超过1MB，避免因尺寸或格式问题导致无法加载。
• 客户端状态适配：如果APP处于前台运行，FCM不会自动弹出通知栏，需要在客户端onMessage回调中手动构建包含图片的通知；仅APP在后台/被杀死状态时，FCM才会自动处理notification字段展示通知。

额外优化建议 #

• 你当前在循环内每次发送后都弹出SnackBar，会导致多次重复弹出，建议将SnackBar移至循环结束后再显示。
• 批量发送通知可使用FCM的主题订阅或批量消息API，替代循环逐个发送的低效方式。

内容的提问来源于stack exchange，提问作者Kushal Hemanth Y