Android：应用离线时将FCM数据插入SQLite数据库

你遇到的问题本质是离线/进程被杀状态下，FCM Data消息的处理逻辑未被可靠触发，导致数据库插入失败。在线时应用处于活跃状态，消息能正常接收并调度WorkManager；但离线时，系统对后台进程的限制、FCM消息优先级配置、WorkManager的约束设置等因素都会影响执行结果。

1. 确保FCM Data消息的高优先级送达 #

FCM的Data消息在应用离线/后台时，默认不会主动唤醒应用进程，除非设置高优先级。

• 发送FCM消息时，在payload中添加高优先级配置：

  "android": {
    "priority": "high"
  }
  

  高优先级的Data消息会触发系统唤醒你的FirebaseMessagingService，即使应用进程已被杀，确保消息接收逻辑能执行。

2. 修正WorkManager的配置 #

你的WorkManager代码存在两个潜在问题：

• 显式声明无需网络约束：虽然插入SQLite不需要网络，但部分设备厂商的定制系统可能隐含网络依赖，需明确禁用：

  Constraints constraints = new Constraints.Builder()
          .setRequiredNetworkType(NetworkType.NOT_REQUIRED)
          .build();
  
  OneTimeWorkRequest workRequest = new OneTimeWorkRequest.Builder(NotificationWorker.class)
          .setInputData(pushNotificationData)
          .setConstraints(constraints)
          .build();
  

• 控制InputData大小：WorkManager的Data对象最大支持约10KB，若pushNotification中的字段（比如imageUrl）过长，会导致数据丢失，Worker解析时出错。建议：
  • 对过长字段做压缩，或存储到SharedPreferences后仅传递标识；
  • 若必须传递完整数据，改用Room临时存储后再由Worker读取。

3. 强化FirebaseMessagingService的可靠性 #

• Manifest注册正确性：确保FirebaseMessagingService在Manifest中正确注册，Android 12+需添加android:exported="true"：

  <service
      android:name=".YourMessagingService"
      android:exported="true">
      <intent-filter>
          <action android:name="com.google.firebase.MESSAGING_EVENT" />
      </intent-filter>
  </service>
  

• 前台服务适配（Android 12+）：若处理消息耗时超过10秒，需启动前台服务避免被系统杀死：

  if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
      ContextCompat.startForegroundService(this, new Intent(this, YourForegroundService.class));
  } else {
      startService(new Intent(this, YourForegroundService.class));
  }
  

  前台服务需在1秒内弹出通知，符合系统要求。

4. 确保Worker中数据库操作的可靠性 #

检查NotificationWorker的doWork()方法：

• 正确解析InputData并处理异常：

  @Override
  public Result doWork() {
      int id = getInputData().getInt("id", -1);
      String title = getInputData().getString("title");
      // 其他字段解析...
  
      if (id == -1 || title == null) {
          return Result.failure();
      }
  
      // 执行数据库插入操作，确保线程安全
      try {
          YourDatabaseHelper dbHelper = new YourDatabaseHelper(getApplicationContext());
          SQLiteDatabase db = dbHelper.getWritableDatabase();
          // 插入逻辑...
          db.close();
          return Result.success();
      } catch (Exception e) {
          e.printStackTrace();
          return Result.retry(); // 失败时触发自动重试
      }
  }
  

• 线程安全：原生SQLite需确保操作在Worker的后台线程执行（WorkManager默认已在后台线程），避免多线程冲突。

5. 适配设备厂商后台限制 #

部分国产厂商（如小米、华为、OPPO）的后台管理策略会限制WorkManager或Service的唤醒，需：

• 在应用设置中开启「自启动权限」；
• 关闭「电池优化」，将应用设为「无限制」后台模式。

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