Android平台FCM通知在深浅模式下颜色不一致问题咨询

阿华AIGC实验室

2026-5-7

关于FCM通知在深浅模式下颜色不一致的问题解析

刚好我之前处理过类似的FCM通知适配问题，来给你捋清楚这里的门道——你遇到的这个情况，其实是FCM静态颜色配置和Android主题自适应机制之间的冲突，官方文档确实没把这个细节单独拎出来讲，我来拆解清楚：

1. 先说说你当前配置的局限

你在AndroidManifest.xml里用<meta-data>配置的default_notification_color是固定色值，这个配置是静态的——它不会跟着系统的深浅模式切换自动调整。当系统切到深色模式时，通知栏背景色会变深，但你的固定颜色要么和新背景对比度失衡，要么系统会自动对这个颜色做过滤调整，导致看起来和浅色模式下不一样。

2. 正确的适配姿势：用主题属性代替固定色值

要解决这个问题，得让通知颜色跟着主题走，步骤很清晰：

先在res/values/colors.xml和res/values-night/colors.xml里分别定义深浅模式对应的通知颜色：

<!-- 浅色模式下的通知色 -->
<color name="notification_accent">#FF6200EE</color>

<!-- 深色模式下的通知色 -->
<color name="notification_accent">#FFBB86FC</color>

接着在res/values/styles.xml的主题里绑定这个颜色到系统通知属性：

<style name="AppTheme" parent="Theme.MaterialComponents.DayNight">
    <item name="android:notificationColor">@color/notification_accent</item>
</style>

最后修改AndroidManifest.xml里的FCM配置，注意这里要用android:resource引用主题属性，而不是android:value：
```
<meta-data
    android:name="com.google.firebase.messaging.default_notification_color"
    android:resource="@attr/android:notificationColor"/>
```
这样FCM就会根据当前系统的主题模式，自动加载对应的颜色值了。

3. 别忘了通知渠道的优先级

如果你已经创建了自定义的通知渠道（Notification Channel），那渠道的颜色设置会覆盖FCM的默认配置。所以创建渠道时也要用主题适配的方式设置颜色：

// 获取适配主题的颜色
val typedValue = TypedValue()
context.theme.resolveAttribute(android.R.attr.notificationColor, typedValue, true)
val notificationColor = ContextCompat.getColor(context, typedValue.resourceId)

// 创建并配置渠道
val channel = NotificationChannel(
    YOUR_CHANNEL_ID,
    "你的通知渠道名称",
    NotificationManager.IMPORTANCE_DEFAULT
).apply {
    color = notificationColor
}
context.getSystemService(NotificationManager::class.java).createNotificationChannel(channel)