如何在React Native中实现APP关闭后每30分钟执行代码（安卓+iOS）

先排查 react-native-background-fetch iOS失效问题 #

很多时候这个包iOS不工作是因为配置不到位，按以下步骤检查：

1. Xcode后台模式配置
   • 打开Xcode，进入项目target的Signing & Capabilities页面
   • 添加Background Modes capability，勾选Background fetch选项
2. Info.plist权限声明
   在Info.plist中添加：

   <key>NSBackgroundRefreshUsageDescription</key>
   <string>需要在后台定期更新数据以提供更好的服务</string>
   

3. 代码中正确配置
   确保初始化代码设置好关键参数（注意iOS系统会根据自身策略调整间隔，无法强制精确30分钟，但可设置最小阈值）：

   import BackgroundFetch from 'react-native-background-fetch';
   
   const initBackgroundFetch = async () => {
     const status = await BackgroundFetch.configure({
       minimumFetchInterval: 30, // iOS最小间隔（单位：分钟）
       stopOnTerminate: false, // APP关闭后继续执行
       startOnBoot: true, // 安卓设备重启后启动任务
     }, async (taskId) => {
       // 这里写要执行的任务逻辑
       console.log('后台任务执行:', taskId);
       // 任务完成必须调用finish，否则iOS会降低调度频率
       BackgroundFetch.finish(taskId);
     }, (error) => {
       console.log('后台配置错误:', error);
     });
   
     console.log('后台权限状态:', status);
   };
   
   // APP启动时初始化
   useEffect(() => {
     initBackgroundFetch();
     return () => {
       BackgroundFetch.stop();
     };
   }, []);
   

如果按上述配置后iOS仍无法正常工作，可结合iOS原生Background Tasks框架实现更可靠的后台任务，步骤如下：

iOS原生Background Tasks备选方案 #

1. 在Xcode中创建BackgroundTaskManager原生模块：

   import UIKit
   import BackgroundTasks
   
   @objc(BackgroundTaskManager)
   class BackgroundTaskManager: NSObject {
     private let taskIdentifier = "com.yourapp.backgroundtask"
   
     override init() {
       super.init()
       BGTaskScheduler.shared.register(forTaskWithIdentifier: taskIdentifier, using: nil) { task in
         self.handleBackgroundTask(task: task as! BGAppRefreshTask)
       }
     }
   
     private func handleBackgroundTask(task: BGAppRefreshTask) {
       // 调度下一次任务
       scheduleNextTask()
       // 执行任务逻辑
       DispatchQueue.global().asyncAfter(deadline: .now() + 5) {
         task.setTaskCompleted(success: true)
       }
     }
   
     private func scheduleNextTask() {
       let request = BGAppRefreshTaskRequest(identifier: taskIdentifier)
       request.earliestBeginDate = Date(timeIntervalSinceNow: 30 * 60) // 30分钟后执行
       do {
         try BGTaskScheduler.shared.submit(request)
       } catch {
         print("提交后台任务失败: \(error)")
       }
     }
   
     @objc func startBackgroundTask() {
       scheduleNextTask()
     }
   
     @objc static func requiresMainQueueSetup() -> Bool {
       return true
     }
   }
   

2. 在AppDelegate中注册模块并触发后台调度：

   func applicationDidEnterBackground(_ application: UIApplication) {
     BackgroundTaskManager().scheduleNextTask()
   }
   

3. 在RN中调用原生模块：

   import { NativeModules } from 'react-native';
   const { BackgroundTaskManager } = NativeModules;
   
   // APP启动时启动任务
   useEffect(() => {
     BackgroundTaskManager.startBackgroundTask();
   }, []);
   

安卓平台实现 #

安卓可直接用react-native-background-fetch配置，或用WorkManager实现更精确的周期性任务：

方案1：react-native-background-fetch配置 #

确保安卓Manifest中添加权限：

<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<uses-permission android:name="android.permission.WAKE_LOCK" />

代码配置和iOS一致，确保stopOnTerminate: false和startOnBoot: true参数正确设置。

方案2：WorkManager原生实现（备选） #

如需更精确的周期，用Android WorkManager创建周期性任务：

class MyWorker(context: Context, params: WorkerParameters) : Worker(context, params) {
   override fun doWork(): Result {
     // 执行任务逻辑
     return Result.success()
   }
}

// 调度任务
val periodicWorkRequest = PeriodicWorkRequestBuilder<MyWorker>(30, TimeUnit.MINUTES)
   .build()
WorkManager.getInstance(context).enqueueUniquePeriodicWork(
   "MyBackgroundTask",
   ExistingPeriodicWorkPolicy.REPLACE,
   periodicWorkRequest
)

通过RN原生桥接调用调度方法即可。

注意事项 #

• iOS系统对后台任务限制严格，即使配置正确，系统也可能根据电量、APP使用频率调整调度时间，无法保证精确30分钟间隔；APP被手动关闭后，iOS可能完全停止后台任务。
• 安卓平台部分厂商定制系统会在APP被强制关闭时终止后台任务，需引导用户开启后台自启权限。
• 后台任务逻辑要轻量化，避免耗时操作，否则会被系统终止。

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