FCM默认图标无效渐变：未使用清单图标，自动fallback至Android标准图标

嘿，我碰到过好几个类似的问题了，结合你说的情况——明明配置了FCM默认图标，却一直显示安卓标准图标，还有Logcat里的E/FirebaseMessaging: Icon with id: 2131230849 uses an invalid gradient. Using fallback icon报错，哪怕你换了好几个单色图标也没用，下面这几个方法应该能帮你搞定：

1. 仔细检查图标XML文件的定义 #

你说图标是单一颜色，但很可能vector drawable文件里藏着渐变相关的代码！打开你的图标XML，确保：

• 没有<gradient>标签
• 所有填充都用<solid android:color="#你的颜色值"/>来定义，或者直接给android:fillColor设纯色（别引用带渐变的颜色资源）

给你举个正确的纯色矢量图标例子：

<vector xmlns:android="http://schemas.android.com/apk/res/android"
    android:width="24dp"
    android:height="24dp"
    android:viewportWidth="24"
    android:viewportHeight="24">
    <path
        android:fillColor="#FF0000"
        android:pathData="M12,2C6.48,2 2,6.48 2,12s4.48,10 10,10 10,-4.48 10,-10S17.52,2 12,2zM12,20c-4.41,0 -8,-3.59 -8,-8s3.59,-8 8,-8 8,3.59 8,8 -3.59,8 -8,8zM12,6c-2.21,0 -4,1.79 -4,4s1.79,4 4,4 4,-1.79 4,-4 -1.79,-4 -4,-4z"/>
</vector>

2. 确认清单文件的FCM图标配置没写错 #

一定要在AndroidManifest.xml的<application>标签下正确配置，别把属性名写错了：

<meta-data
    android:name="com.google.firebase.messaging.default_notification_icon"
    android:resource="@drawable/你的FCM图标"/>

• 别写成com.google.firebase.messaging.default_icon（这是错误的属性名）
• 确保@drawable/你的FCM图标指向的是你检查过的纯色图标资源

3. 满足FCM对图标的规格要求 #

FCM对通知图标有严格的要求，别踩坑：

• 必须是透明背景的纯色图标，不能有渐变、阴影或者复杂图案
• 尺寸要符合安卓通知图标规范：至少提供48x48dp的图标，同时要适配mdpi、hdpi、xhdpi等不同密度的屏幕
• 尽量用不透明的纯色，别用半透明的颜色

4. 清理缓存并重新构建项目 #

有时候缓存会导致资源不更新，按下面的步骤来：

• 点击Android Studio里的Build > Clean Project
• 然后点击Build > Rebuild Project
• 卸载设备上的旧应用，再重新安装新构建的版本

5. 用Firebase控制台发送测试通知验证 #

通过Firebase控制台发送测试通知的时候，别指定自定义图标，这样FCM就会用你在清单里配置的默认图标。然后看Logcat，如果渐变相关的报错消失了，说明图标配置成功了。

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