React Native回到active状态时终止后台任务问题求解

问题描述 #

React Native安卓应用开发过程中出现后台任务无法正常终止的问题，初始实现逻辑如下：

• 借助appState钩子监听应用状态，判断应用处于foreground（前台）或background（后台）
• 当appState切换为*'background'*状态时，调用react-native-background-action库的BackgroundJob.start()方法启动后台任务
• 当appState切换为*'active'*状态（应用返回前台）时，调用BackgroundJob.stop()方法停止后台任务

该实现在强制杀死应用场景下出现异常：杀死应用后会丢失此前启动的后台任务引用，导致每次杀应用重启后都会重复新增后台任务，最终引发应用运行性能异常。
业务背景：应用内置唤醒词触发的语音识别功能，需要在应用处于后台时保持监听状态。

初始核心实现代码：

useEffect(() => {
    const startBackgroundListening = async () => {
      await BackgroundJob.start(backgroundListening, backgroundOptions);
    };
    const stopPorcupine = async () => {
        await porcupineRef.current?.stop();
        porcupineRef.current?.delete();
    };
    if (currentAppState === 'background') {
      if (isLoggedIn) {
        if (isNotificationShowed === false) {
          handleNotification(
            i18n.t('closingWarning'),
            i18n.t('closingWarningText'),
          );
          uiStore.updateIsNotificationShowed(true);
        }
        if ((isRecord || isCall || isSms || isAlarm) && isBackgroundListeningRunning.current === false) {
          //start background listenning
          startBackgroundListening();
          isBackgroundListeningRunning.current = true;
        }
      }
    } else if (currentAppState === 'active') {
      //stop and delete background listenning in case there is one
        stopPorcupine();
        BackgroundJob.stop();
        isBackgroundListeningRunning.current = false;
    }
  }, [currentAppState]);

问题根因 #

当前实现存在两个核心缺陷：

1. 任务运行状态标记isBackgroundListeningRunning存储在ref内存中，应用被强制杀死、进程销毁后内存数据完全清空，重启后标记默认为false，无法感知之前残留的后台任务
2. 仅依赖JS层appState监听触发任务停止逻辑，应用被强杀时JS线程直接被回收，根本来不及执行BackgroundJob.stop()。而react-native-background-action调度的任务是注册在系统JobScheduler/WorkManager服务侧的，不会随进程销毁自动清除，重启后重复调用start就会叠加多个任务。

可落地方案 #

• 新增持久化任务状态标记：不要只用内存ref存储任务运行状态，用AsyncStorage或MMKV存储is_bg_job_running布尔值，任务启动成功后置为true，任务停止成功后置为false。在应用冷启动初始化阶段先读取该值，如果为true，先主动调用一次BackgroundJob.stop()清理残留任务，再走后续业务逻辑，从根源避免重复创建。
• 补全进程销毁场景的清理逻辑：不要只依赖JS层的appState监听，在安卓原生层注册Application的onTaskRemoved回调，回调中主动触发后台任务的stop方法，覆盖应用被强杀的场景。
• 给后台任务配置固定唯一ID：启动任务时传入固定的jobId，启动前先调用库提供的已调度任务查询方法，判断同ID任务是否已存在，存在则先停止再启动，避免盲目创建新任务。
• 针对唤醒词语音监听场景替换实现方案：react-native-background-action这类库本质基于WorkManager实现定时短任务，不支持连续麦克风采集长驻，安卓12+对后台麦克风权限限制极严，普通后台任务切后台数分钟就会被系统挂起。建议替换为安卓前台服务（Foreground Service）实现，启动监听时绑定常驻通知栏将服务优先级提升至前台，既可以保证麦克风持续采集不被系统回收，服务也会和应用进程绑定，进程销毁时服务自动移除，不会残留僵尸任务。

修改后核心逻辑参考 #

import AsyncStorage from '@react-native-async-storage/async-storage';

const LISTEN_JOB_ID = 'porcupine_wakeup_listen';

// 应用冷启动初始化阶段执行，仅跑一次
useEffect(() => {
  const cleanResidualJob = async () => {
    const isJobRunning = await AsyncStorage.getItem('is_bg_job_running');
    if (isJobRunning === 'true') {
      await BackgroundJob.stop(LISTEN_JOB_ID);
      await AsyncStorage.setItem('is_bg_job_running', 'false');
    }
  };
  cleanResidualJob();
}, []);

// 原有appState监听逻辑修改
useEffect(() => {
    const startBackgroundListening = async () => {
      // 启动前先检查是否存在同ID残留任务
      const scheduledJobs = await BackgroundJob.scheduledJobs();
      if (scheduledJobs.includes(LISTEN_JOB_ID)) {
        await BackgroundJob.stop(LISTEN_JOB_ID);
      }
      await BackgroundJob.start(backgroundListening, {
        ...backgroundOptions,
        jobId: LISTEN_JOB_ID
      });
      await AsyncStorage.setItem('is_bg_job_running', 'true');
    };

    const stopPorcupine = async () => {
        await porcupineRef.current?.stop();
        porcupineRef.current?.delete();
    };

    const stopBackgroundListening = async () => {
      await BackgroundJob.stop(LISTEN_JOB_ID);
      await AsyncStorage.setItem('is_bg_job_running', 'false');
      isBackgroundListeningRunning.current = false;
    };

    if (currentAppState === 'background') {
      if (isLoggedIn) {
        if (isNotificationShowed === false) {
          handleNotification(
            i18n.t('closingWarning'),
            i18n.t('closingWarningText'),
          );
          uiStore.updateIsNotificationShowed(true);
        }
        if ((isRecord || isCall || isSms || isAlarm) && isBackgroundListeningRunning.current === false) {
          startBackgroundListening();
          isBackgroundListeningRunning.current = true;
        }
      }
    } else if (currentAppState === 'active') {
        stopPorcupine();
        stopBackgroundListening();
    }
  }, [currentAppState]);

注意：如果需要实现后台稳定持续的唤醒词监听，务必替换为前台服务方案，通用后台任务在国内定制安卓ROM、高版本原生安卓系统上都会出现后台运行1-3分钟就被系统强制回收的问题，无法满足持续麦克风采集的需求。

内容的提问来源于stack exchange，提问作者boris-lipo