Android端Flutter应用关闭后后台定位服务未停止如何解决

服务无法随应用关闭自动停止、二次启动功能异常，核心是三处逻辑/配置错误：

• LocationService的onStartCommand返回START_STICKY，该标记会让服务在应用进程被杀死后被系统自动拉起，不会随应用任务移除自动销毁
• Manifest配置的android:stopWithTask="true"和服务内重写的onTaskRemoved逻辑冲突，且onTaskRemoved、onDestroy中仅修改了服务状态标记，没有实际停止位置监听、释放定位资源，导致定位逻辑残留
• Flutter层的dispose、AppLifecycleState.detached回调触发时机不可靠：用户直接划掉应用任务时，Flutter引擎会被快速销毁，根本来不及执行Dart层的方法通道调用，你写的停止服务逻辑实际不会运行。

第一步：修改Service生命周期逻辑，补全资源释放 #

打开LocationService.kt做如下调整：

1. 将onStartCommand返回值从START_STICKY改为START_NOT_STICKY，禁止服务在进程被杀后被系统自动重启
2. 在onDestroy、onTaskRemoved回调中补全定位监听停止逻辑，不要仅修改状态标记
   对应修改后的代码：

override fun onStartCommand(intent: Intent, flags: Int, startId: Int): Int {
    LocationHelper().startListeningLocation(this, duration, distance);
    // 替换原START_STICKY，进程销毁后不自动重启服务
    return START_NOT_STICKY
}

override fun onDestroy() {
    // 主动移除位置监听，释放定位资源
    LocationHelper().stopListeningLocation(this)
    isServiceStarted = false
    super.onDestroy()
}

override fun onTaskRemoved(rootIntent: Intent?) {
    // 应用任务被划掉时，主动停止定位、销毁服务
    LocationHelper().stopListeningLocation(this)
    stopSelf()
    isServiceStarted = false
    super.onTaskRemoved(rootIntent)
}

注意：如果你的LocationHelper没有实现stopListeningLocation方法，需要自行补全，核心逻辑是调用LocationManager.removeUpdates(你的位置监听器实例)移除定位回调，否则定位模块会持续在后台运行耗电。

第二步：调整Manifest服务配置，移除冲突项 #

打开AndroidManifest.xml修改服务声明，删除和自定义onTaskRemoved逻辑冲突的android:stopWithTask="true"属性，关闭不必要的导出权限，同时适配高版本安卓前台服务要求：

<service
    android:name=".LocationService"
    android:enabled="true"
    android:exported="false"
    android:foregroundServiceType="location" />

如果应用targetSdk版本为34及以上，必须配置android:foregroundServiceType="location"，否则前台定位服务会直接触发系统崩溃。

第三步：将服务停止逻辑下沉到原生层，不依赖Flutter回调 #

因为Dart层生命周期回调在应用被快速划掉时无法保证执行，停止逻辑必须放在原生Activity生命周期中。修改MainActivity.kt的onDestroy方法，补全服务停止逻辑：

override fun onDestroy() {
    try {
        if (locationUpdateReceiver != null ) {
            unregisterReceiver(locationUpdateReceiver)
            locationUpdateReceiver = null
        }
        // Activity销毁时主动停止定位服务，无需等待Flutter层调用
        if (isServiceStarted) {
            stopService(this)
            isServiceStarted = false
        }
    } catch (e: Exception) {
        e.printStackTrace()
    }
    super.onDestroy()
}

第四步：清理Flutter层冗余的停止逻辑 #

删除你在dispose、didChangeAppLifecycleState中监听AppLifecycleState.detached状态调用停止服务的代码：这部分逻辑触发时机没有保障，且原生层已经实现了自动停止逻辑，保留反而可能引发重复注销广播的崩溃。

修改完成后按以下场景测试：

• 启动应用开启定位，直接从最近任务列表划掉应用，观察通知栏定位图标是否消失，确认服务没有后台残留
• 再次启动应用，定位功能可以正常开启、关闭，无二次启动异常
• 效果和手动点击按钮停止服务再关应用、通过Force Stop强制停止应用的表现完全一致。

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