如何在设备重启后终止已绑定的ForegroundService避免多实例运行

问题根因 #

设备重启后系统会根据服务onStartCommand返回的粘性标识，自动重启此前未正常销毁的前台服务，该服务因重启后原绑定连接已失效，无客户端触发解绑逻辑，会一直保留在前台运行。客户端重新绑定时若未做运行状态校验直接启动新前台任务，要么重复调用startForeground使用不同通知ID产生两条通知，要么极端场景下产生多服务实例。

可落地解决方案 #

1. 从根源避免系统无意义重启服务 #

将服务onStartCommand返回值修改为START_NOT_STICKY，系统重启后不会主动重新拉起没有未处理Intent的服务，从源头减少旧实例产生概率：

override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
    // 原有业务逻辑
    return START_NOT_STICKY
}

2. 绑定前先校验并停止已运行的旧服务 #

绑定服务前通过ActivityManager查询当前应用正在运行的服务，存在对应服务实例时先停止再绑定，实现启动新实例前清理旧服务的需求：

// 判断目标服务是否正在运行
private fun isServiceRunning(serviceClass: Class<*>): Boolean {
    val am = getSystemService(Context.ACTIVITY_SERVICE) as ActivityManager
    return am.getRunningServices(Int.MAX_VALUE).any {
        it.service.className == serviceClass.name
    }
}

// 绑定前的调用逻辑
if (isServiceRunning(YourForegroundService::class.java)) {
    stopService(Intent(this, YourForegroundService::class.java))
}
// 后续执行bindService逻辑

3. 统一前台通知ID避免重复通知 #

全局使用固定的通知ID调用startForeground，多次调用也只会覆盖同ID通知，不会出现多条通知：

// 全局唯一固定的前台服务通知ID
private const val FG_NOTIFICATION_ID = 1024

// 启动前台时统一使用该ID
startForeground(FG_NOTIFICATION_ID, yourNotification)

4. 服务内部增加绑定计数自动销毁无客户端的服务 #

在服务内维护绑定计数，当没有绑定端时自动停止前台并销毁自身，解决系统拉起的无绑定旧服务长期运行问题：

private var bindClientCount = 0

override fun onBind(intent: Intent?): IBinder {
    bindClientCount++
    return yourBinderInstance
}

override fun onUnbind(intent: Intent?): Boolean {
    bindClientCount--
    if (bindClientCount <= 0) {
        // 移除前台通知并销毁服务
        stopForeground(Service.STOP_FOREGROUND_REMOVE)
        stopSelf()
    }
    return super.onUnbind(intent)
}

override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
    // 系统重启拉起服务时无绑定端，直接销毁
    if (bindClientCount <= 0) {
        stopSelf(startId)
        return START_NOT_STICKY
    }
    // 原有业务逻辑
    return START_NOT_STICKY
}

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