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

升级FCM V1后通知图标显示为白方块问题求助

FCM V1通知图标显示白方块的原因及解决办法
  • 图标规范未达标:FCM V1严格遵循Android系统通知图标要求——必须是透明背景+白色单色前景的图标。旧版FCM可能对不符合规范的图标做了兼容处理,V1则强制执行标准,非合规图标就会显示白块。检查你的图标是否符合要求,重新制作透明背景的白色图标替换。

  • API参数配置错误:V1的请求结构和旧版不同,图标字段的位置或写法有变化。旧版可能直接在根节点写"icon": "ic_notification",而V1需要嵌套在notification.android对象下,示例:

{
  "message": {
    "notification": {
      "title": "测试通知",
      "body": "内容"
    },
    "android": {
      "notification": {
        "icon": "ic_notification",
        "color": "#ff0000"
      }
    },
    "token": "设备令牌"
  }
}

确保icon字段值是你的图标资源名称(不需要加@drawable/或@mipmap/前缀)。

  • 图标资源缺失或路径错误:检查项目中所有分辨率的drawable文件夹(drawable-mdpi、drawable-hdpi等)是否都放置了对应尺寸的图标,且资源名称完全一致。V1的资源查找逻辑可能比旧版更严格,缺少某一分辨率的图标会导致 fallback到默认白块。

  • 通知渠道配置问题:如果你的应用使用了通知渠道,确认渠道的图标设置正确。V1中通知渠道的配置会影响通知显示,若渠道图标未正确设置或与通知图标冲突,也可能出现白块。可以尝试重新创建通知渠道,或确保渠道图标符合规范。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.06.27 08:32:34