应用关联Activity生命周期启停服务时startService()抛IllegalArgumentException

这个问题我之前也碰到过，本质是Android从API 26开始引入的后台服务启动限制在捣鬼。当应用处于后台状态（没有可见的Activity）时，直接调用startService()会触发这个异常，而你用ActivityLifecycleCallbacks时，可能存在时序上的小问题——比如第一个Activity启动时，系统还没完全把应用标记为前台进程，这时候调用startService()就踩了限制的坑。

下面是具体的解决方案，兼顾兼容性和正确性：

1. 改用前台服务启动方式 #

从API 26开始，Android不允许后台应用直接启动普通服务，必须使用startForegroundService()，同时要在服务启动后的5秒内调用startForeground()显示一个前台通知，这样才能绕过限制。

2. 优化Activity生命周期计数逻辑 #

之前的逻辑可能依赖onCreate()/onDestroy()来判断应用的前后台状态，这会导致Activity重建（比如屏幕旋转）时计数出错。正确的做法是用onStart()和onStop()来跟踪活跃Activity的数量：

• 当计数从0变为1时：说明应用首次启动或从后台回到前台，启动服务
• 当计数变为0时：说明所有Activity都已停止，停止服务

完整代码示例 #

自定义Application类（注册生命周期回调） #

class MyApp : Application() {
    private var activeActivityCount = 0

    override fun onCreate() {
        super.onCreate()
        registerActivityLifecycleCallbacks(object : ActivityLifecycleCallbacks {
            override fun onActivityCreated(activity: Activity, savedInstanceState: Bundle?) {}

            override fun onActivityStarted(activity: Activity) {
                activeActivityCount++
                // 仅当第一个活跃Activity出现时启动服务
                if (activeActivityCount == 1) {
                    val serviceIntent = Intent(this@MyApp, MyForegroundService::class.java)
                    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
                        startForegroundService(serviceIntent)
                    } else {
                        // 低于API26的版本可以直接用startService
                        startService(serviceIntent)
                    }
                }
            }

            override fun onActivityResumed(activity: Activity) {}

            override fun onActivityPaused(activity: Activity) {}

            override fun onActivityStopped(activity: Activity) {
                activeActivityCount--
                // 所有Activity都停止时关闭服务
                if (activeActivityCount == 0) {
                    val serviceIntent = Intent(this@MyApp, MyForegroundService::class.java)
                    stopService(serviceIntent)
                }
            }

            override fun onActivitySaveInstanceState(activity: Activity, outState: Bundle) {}

            override fun onActivityDestroyed(activity: Activity) {}
        })
    }
}

前台Service实现 #

class MyForegroundService : Service() {
    private companion object {
        const val NOTIFICATION_ID = 1001
        const val CHANNEL_ID = "ForegroundServiceChannel"
    }

    override fun onCreate() {
        super.onCreate()
        // 先创建通知通道（API26+要求）
        createNotificationChannel()
        // 启动前台服务并显示通知
        val notification = NotificationCompat.Builder(this, CHANNEL_ID)
            .setContentTitle("应用服务运行中")
            .setContentText("当前应用处于前台活跃状态")
            .setSmallIcon(R.drawable.ic_service_notification) // 替换为你的通知图标
            .build()
        startForeground(NOTIFICATION_ID, notification)
    }

    override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
        // 根据你的业务需求选择返回值，这里用START_STICKY表示服务被杀死后会尝试重启
        return START_STICKY
    }

    override fun onBind(intent: Intent): IBinder? {
        // 如果不需要绑定服务，返回null即可
        return null
    }

    override fun onDestroy() {
        super.onDestroy()
        // 停止前台并移除通知
        stopForeground(true)
    }

    private fun createNotificationChannel() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            val channel = NotificationChannel(
                CHANNEL_ID,
                "前台服务通知",
                NotificationManager.IMPORTANCE_LOW // 低优先级，避免打扰用户
            )
            val notificationManager = getSystemService(NotificationManager::class.java)
            notificationManager.createNotificationChannel(channel)
        }
    }
}

清单文件配置 #

别忘了在AndroidManifest.xml中注册服务和添加必要权限：

<!-- 注册服务 -->
<service android:name=".MyForegroundService" />

<!-- API31+需要的通知权限 -->
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

关键注意点 #

• 通知权限：Android 12（API31）及以上版本需要动态申请POST_NOTIFICATIONS权限，否则通知无法显示，服务可能会被系统杀死。
• 前台通知：必须在startForegroundService()调用后的5秒内调用startForeground()，否则系统会抛出ANR异常。
• 计数逻辑：用onStart()/onStop()而不是onCreate()/onDestroy()，能避免Activity重建时的计数错误，比如屏幕旋转、配置变更等场景。

内容的提问来源于stack exchange，提问作者Алексей Мальченко