Android startForeground启动失败：Bad notification问题排查

你的问题核心在于没有给Notification设置小图标（Small Icon），这是Android O（API 26）及以上版本中通知的强制要求，卸载重装后首次触发时就会因为这个缺失抛出RemoteServiceException。

为什么之前正常现在报错？ #

之前运行正常可能是因为旧版本Android系统对通知图标的校验不严格，或是你之前的代码隐式配置过图标；而卸载重装后应用的所有本地存储被清空，首次创建通知时缺少必填的小图标，直接触发了系统的校验逻辑。

修复步骤： #

1. 给NotificationCompat.Builder添加setSmallIcon()方法，传入你的应用图标资源（比如R.drawable.ic_notification，需要提前在res/drawable目录准备好符合要求的纯色图标）
2. 优化NotificationChannel的创建逻辑：不需要用SharedPreferences记录创建状态，createNotificationChannel()是幂等方法，重复调用不会报错，反而能避免存储状态异常带来的问题

修改后的代码如下：

val notificationIntent = Intent(this, MainActivity::class.java)
// Android 12+ 需指定PendingIntent的flag，根据业务需求选择IMMUTABLE/MUTABLE
val pendingIntent = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
    PendingIntent.getActivity(this, 0, notificationIntent, PendingIntent.FLAG_IMMUTABLE)
} else {
    PendingIntent.getActivity(this, 0, notificationIntent, 0)
}

val channelId = "noti_channel"
// 直接创建Channel，系统会自动忽略已存在的同ID通道
val channel = NotificationChannel(channelId, "Notification Channel", NotificationManager.IMPORTANCE_DEFAULT)
(getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager).createNotificationChannel(channel)

val builder = NotificationCompat.Builder(this, channelId)
    .setContentTitle("Location Service")
    .setContentText("Service running in foreground")
    .setContentIntent(pendingIntent)
    .setSmallIcon(R.drawable.ic_notification) // 关键：添加必填的小图标
    .setPriority(NotificationCompat.PRIORITY_DEFAULT)

startForeground(502, builder.build())

额外注意事项： #

• 小图标必须是纯色样式（系统会根据主题自动适配为白/灰色），使用带透明或复杂色彩的图片可能导致显示异常
• 若你的应用需要兼容Android 12及以上版本，务必为PendingIntent指定FLAG_IMMUTABLE或FLAG_MUTABLE，否则会抛出兼容性异常

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