Android 13/14中setOngoing(true)前台通知仍可被关闭问题排查

问题 #

在Android中使用前台服务，为确保用户处于对应页面时服务不被终止，已调用startForeground()，同时设置setOngoing(true)以防止通知被关闭，核心代码如下：

val notification = NotificationCompat.Builder(context, channelId)
    .setSmallIcon(R.drawable.app_icon)
    .setContent(contentViews)
    .setContentIntent(getMyPendingIntent(REQUEST_CODE))
    .setCategory(Notification.CATEGORY_SERVICE)
    .setOngoing(true)
    .build()

service.startForeground(notificationId, notification)

测试发现：Android 12中通知无法被滑动关闭，符合预期；但Android 13和14中通知会被用户滑动消失，与官方文档中setOngoing(true)应阻止通知关闭的描述不符。

即使移除自定义视图，改用contentTitle和contentText，问题仍存在：

val notification = NotificationCompat.Builder(context, channelId)
    .setSmallIcon(R.drawable.app_icon)
//            .setContent(contentViews)
    .setContentTitle("Hello")
    .setContentText("World")
    .setContentIntent(getMyPendingIntent(REQUEST_CODE))
    .setCategory(Notification.CATEGORY_SERVICE)
    .setOngoing(true)
    .build()

service.startForeground(notificationId, notification)

补充：该服务是从Fragment中通过绑定方式启动的，绑定代码如下：

val intent = Intent(requireContext(), service)
requireContext().bindService(intent, object : ServiceConnection {
    override fun onServiceConnected(name: ComponentName, service: IBinder) {
        val notification = NotificationCompat.Builder(context, channelId)
            .setSmallIcon(R.drawable.app_icon)
            .setContent(contentViews)
            .setContentIntent(getMyPendingIntent(REQUEST_CODE))
            .setCategory(Notification.CATEGORY_SERVICE)
            .setOngoing(true)
            .build()

        (service as? MyService)?.startForeground(notificationId, notification)
    }

    override fun onServiceDisconnected(name: ComponentName) { }
}, Service.BIND_AUTO_CREATE)

原因分析 #

1. 绑定服务的生命周期限制：使用BIND_AUTO_CREATE绑定服务时，服务的生命周期完全依赖于绑定的Fragment/Activity。当宿主组件进入后台或被销毁，系统会自动解除绑定，此时前台服务的状态可能被系统重置，导致setOngoing(true)的锁定失效。
2. Android 13+的前台服务规范变更：Android 13及以上版本对前台服务的启动流程要求更严格，仅通过绑定启动服务后再调用startForeground()，不符合系统认可的前台服务启动标准（需先通过startService/startForegroundService启动服务），因此系统会忽略setOngoing(true)的设置。
3. 启动时机错误：在onServiceConnected回调中调用startForeground()，此时服务已处于绑定状态，而非标准的启动状态，Android 13+不会将其视为合法的前台服务，导致通知的持续属性不生效。

解决方案 #

1. 遵循标准前台服务启动流程 #

先通过startForegroundService（Android 8.0+）或startService启动服务，再在服务内部调用startForeground()，而非仅通过绑定启动：

Fragment中代码：

// 先启动服务
val startIntent = Intent(requireContext(), MyService::class.java)
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    requireContext().startForegroundService(startIntent)
} else {
    requireContext().startService(startIntent)
}

// 再绑定服务
val bindIntent = Intent(requireContext(), MyService::class.java)
requireContext().bindService(bindIntent, object : ServiceConnection {
    override fun onServiceConnected(name: ComponentName, service: IBinder) {
        // 处理服务绑定后的业务逻辑，无需在此调用startForeground
    }

    override fun onServiceDisconnected(name: ComponentName) { }
}, Service.BIND_AUTO_CREATE)

MyService内部代码：

class MyService : Service() {
    override fun onCreate() {
        super.onCreate()
        initForegroundNotification()
    }

    override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
        // 确保通知已初始化
        initForegroundNotification()
        return START_STICKY
    }

    private fun initForegroundNotification() {
        val notification = NotificationCompat.Builder(this, channelId)
            .setSmallIcon(R.drawable.app_icon)
            .setContentTitle("Hello")
            .setContentText("World")
            .setContentIntent(getMyPendingIntent(REQUEST_CODE))
            .setCategory(Notification.CATEGORY_SERVICE)
            .setOngoing(true)
            .build()
        startForeground(notificationId, notification)
    }

    // 实现IBinder逻辑
    override fun onBind(intent: Intent): IBinder {
        return MyBinder()
    }

    inner class MyBinder : Binder() {
        fun getService(): MyService = this@MyService
    }
}

2. 确保通知通道配置合规 #

检查通知通道的重要性级别，避免设置为低优先级导致系统忽略ongoing属性：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    val channel = NotificationChannel(
        channelId,
        "前台服务通知",
        NotificationManager.IMPORTANCE_DEFAULT
    ).apply {
        description = "显示前台服务运行状态"
    }
    val notificationManager = getSystemService(NotificationManager::class.java)
    notificationManager.createNotificationChannel(channel)
}

3. 处理解绑后的服务状态 #

在服务的onUnbind方法中返回true，允许后续重新绑定，同时确保服务在解绑后仍保持前台状态：

override fun onUnbind(intent: Intent?): Boolean {
    // 返回true支持重新绑定
    return true
}

内容的提问来源于stack exchange，提问作者dev.farmer