React Native应用被杀死时后台调用API的实现问题

一、修正HeadlessJS基础代码 #

你当前代码存在重复注册任务的问题，正确写法如下：

App.js #

import { AppRegistry } from 'react-native';
import App from './App';
import { name as appName } from './app.json';

// 仅在App.js中注册一次无头任务
AppRegistry.registerHeadlessTask('MyTask', () => require('./MyTask'));

AppRegistry.registerComponent(appName, () => App);

MyTask.js #

// 导出异步处理函数，无需重复注册任务
module.exports = async (taskData) => {
  try {
    // 写入你的API调用逻辑
    const response = await fetch('https://your-api-url.com/endpoint');
    const data = await response.json();
    console.log('API调用结果:', data);
  } catch (error) {
    console.error('API调用失败:', error);
  }
  // 任务完成后必须返回，避免内存泄漏
  return Promise.resolve();
};

二、实现应用被杀时的触发机制（Android） #

HeadlessJS不会自动在应用被杀后启动任务，必须依赖Android系统调度组件触发，以下用AlarmManager + BroadcastReceiver实现定时触发：

1. 创建Android原生广播接收器 #

在android/app/src/main/java/com/yourappname/路径下新建HeadlessTaskReceiver.java（替换com/yourappname为你的应用包名）：

package com.yourappname;

import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import androidx.annotation.NonNull;
import com.facebook.react.HeadlessJsTaskService;
import com.facebook.react.bridge.Arguments;
import com.facebook.react.jstasks.HeadlessJsTaskConfig;

public class HeadlessTaskReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        // 配置要触发的Headless任务
        HeadlessJsTaskConfig taskConfig = new HeadlessJsTaskConfig(
                "MyTask",
                Arguments.createMap(), // 传递给任务的参数（可选）
                5000, // 任务超时时间，单位ms
                false // 是否允许前台运行时触发
        );
        HeadlessJsTaskService.acquireWakeLockNow(context);
        HeadlessJsTaskService.startTask(context, taskConfig);
    }
}

2. 在AndroidManifest.xml注册权限与组件 #

打开android/app/src/main/AndroidManifest.xml，添加以下内容：

<!-- 添加必要权限 -->
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />

<!-- 在<application>标签内注册广播接收器 -->
<receiver
    android:name=".HeadlessTaskReceiver"
    android:enabled="true"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.BOOT_COMPLETED" />
        <action android:name="com.yourappname.TRIGGER_HEADLESS_TASK" />
    </intent-filter>
</receiver>

<!-- 注册Headless任务服务 -->
<service
    android:name="com.facebook.react.HeadlessJsTaskService"
    android:enabled="true"
    android:exported="true" />

3. 编写原生调度模块 #

在android/app/src/main/java/com/yourappname/路径下新建TaskSchedulerModule.java：

package com.yourappname;

import android.app.AlarmManager;
import android.app.PendingIntent;
import android.content.Context;
import android.content.Intent;
import com.facebook.react.bridge.ReactApplicationContext;
import com.facebook.react.bridge.ReactContextBaseJavaModule;
import com.facebook.react.bridge.ReactMethod;
import java.util.Calendar;

public class TaskSchedulerModule extends ReactContextBaseJavaModule {
    private Context context;

    public TaskSchedulerModule(ReactApplicationContext reactContext) {
        super(reactContext);
        context = reactContext;
    }

    @Override
    public String getName() {
        return "TaskScheduler";
    }

    @ReactMethod
    public void scheduleRepeatingTask(long intervalMillis) {
        AlarmManager alarmManager = (AlarmManager) context.getSystemService(Context.ALARM_SERVICE);
        Intent intent = new Intent(context, HeadlessTaskReceiver.class);
        intent.setAction("com.yourappname.TRIGGER_HEADLESS_TASK");
        PendingIntent pendingIntent = PendingIntent.getBroadcast(
                context,
                0,
                intent,
                PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE
        );

        // 设置首次触发时间为当前时间后10秒，之后按间隔重复触发
        Calendar calendar = Calendar.getInstance();
        calendar.add(Calendar.SECOND, 10);

        // 适配不同Android版本的闹钟规则
        if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.M) {
            alarmManager.setExactAndAllowWhileIdle(AlarmManager.RTC_WAKEUP, calendar.getTimeInMillis(), pendingIntent);
        } else {
            alarmManager.setRepeating(AlarmManager.RTC_WAKEUP, calendar.getTimeInMillis(), intervalMillis, pendingIntent);
        }
    }
}

然后在MainApplication.java的getPackages方法中添加该模块：

@Override
protected List<ReactPackage> getPackages() {
    List<ReactPackage> packages = new PackageList(this).getPackages();
    // 加入自定义调度模块
    packages.add(new TaskSchedulerModule());
    return packages;
}

4. RN侧调用定时任务 #

在App.js中，应用启动时调用原生模块设置定时：

import { NativeModules, useEffect } from 'react-native';

const { TaskScheduler } = NativeModules;

// 组件挂载时设置每30分钟触发一次任务
useEffect(() => {
  // 30分钟 = 30 * 60 * 1000 = 1800000毫秒
  TaskScheduler.scheduleRepeatingTask(1800000);
}, []);

三、iOS平台限制说明 #

iOS对后台任务管控严格，应用被杀后几乎无法触发常规后台任务，仅VoIP、实时地理位置更新等特殊场景可实现有限后台运行。若需支持iOS，可尝试基于iOS Background Tasks框架的第三方库，但无法实现应用被杀后的持续API调用。

四、常见问题排查 #

• 权限缺失：确保已申请WAKE_LOCK、RECEIVE_BOOT_COMPLETED权限，Android 12及以上需额外申请FOREGROUND_SERVICE权限。
• Doze模式影响：AlarmManager在Doze模式下会延迟触发，使用setExactAndAllowWhileIdle可在该模式下触发，但系统限制每15分钟最多一次。
• 任务超时：Headless任务必须在指定超时时间内完成，否则会被系统强制终止，建议API调用逻辑保持简洁高效。

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