Android 6.0(API23)状态栏通知图标不生效问题排查
排查Android 6.0前台通知图标不显示问题
遇到这种跨API版本的图标显示异常,咱们一步步拆解排查:
首先得明确:Android 6.0(API 23)开始对通知图标有了强制规范——必须是纯白、透明背景的单色图标,系统会自动把非白色区域转为透明,不符合规范的图标会被系统替换成应用默认图标。不过你说已经试过白色图标,那咱们继续往下排查:
1. 检查图标资源的配置兼容性
- 如果用的是矢量图标(xml格式):
要确保Module级别的build.gradle里开启了矢量图支持,避免系统无法解析:android { defaultConfig { vectorDrawables.useSupportLibrary = true } } - 如果用的是png图标:
必须在drawable-mdpi、drawable-hdpi、drawable-xhdpi等不同dpi目录下,放置对应尺寸的图标(通知图标标准尺寸为24x24dp,对应各dpi的像素值分别是24px、36px、48px等),缺失某类dpi资源可能导致系统在对应设备上 fallback 到默认图标。
2. 确认NotificationCompat的依赖与使用正确性
- 如果你用的是AndroidX库,务必导入
androidx.core.app.NotificationCompat,而非旧版的android.support.v4.app.NotificationCompat,同时确保AndroidX core库的版本足够新,避免兼容性bug。 - 检查代码中有没有在
build()之后、startForeground()之前,意外调用原生Notification的setIcon()方法覆盖了设置(注意setIcon()和setSmallIcon()是不同的API)。
3. 用官方工具生成合规图标
手动制作的图标可能存在细微的规范问题(比如边缘有灰色像素、背景未完全透明),建议用Android Studio的Image Asset Studio生成标准通知图标:
- 右键res目录 → New → Image Asset
- 选择Icon Type为Notification Icons,按照向导生成,这样产出的图标完全符合各Android版本的规范,避免手动制作的疏漏。
4. 清除缓存并重置测试环境
系统可能缓存了旧的图标资源,导致新图标无法生效:
- 进入设备应用设置,找到你的应用,清除缓存和数据后重启应用测试;
- 也可以尝试卸载应用后重新安装,确保没有残留的旧资源干扰。
5. 排查代码中的其他干扰逻辑
- 检查是否有其他代码在
startForeground之后,重新构建通知并调用notify(),覆盖了之前的前台通知图标; - 确认
MY_ID这个通知ID没有被其他通知复用,导致图标被意外替换。
附上你提供的代码(整理格式后):
NotificationCompat.Builder notificationBuilder = new NotificationCompat.Builder(this, "unique") .setSmallIcon(R.drawable.ic_mms_black_24dp) .setContentTitle("My notification") .setContentText("Hello World!") .setPriority(NotificationCompat.PRIORITY_DEFAULT); Notification notification = notificationBuilder.build(); startForeground(MY_ID, notification);
按照上面的步骤逐一排查,大概率能定位到问题所在。
内容的提问来源于stack exchange,提问作者Lakindu Akash




