在Firebase onMessageReceived中后台执行数据库操作失败求助

我希望在Firebase的onMessageReceived(...)方法触发时立即执行Realtime Database操作。目前仅应用处于前台时，读取或更新等CRUD操作能正常生效；但应用处于后台时，这些操作完全无法执行。

代码示例：

@Override
public void onMessageReceived(@NonNull RemoteMessage remoteMessage) {
  super.onMessageReceived(remoteMessage);

  // 示例CRUD操作
  FirebaseDatabase.getInstance()
      .getReference("test_node")
      .child("test_child")
      .get() // 也试过替换成setValue(...)等其他CRUD操作，依然无效
      ...
}

已尝试的解决方案：

• FirebaseApp.initializeApp(context)
• FirebaseDatabase.getInstance().goOnline();

请问这一问题的原因是什么，我可能哪里操作出错了？

核心原因 #

当应用处于后台时，onMessageReceived所在的Firebase Messaging Service进程会被系统限制资源，且Android（尤其是API 26+）的后台执行限制会阻断未授权的网络操作；另外onMessageReceived本身有执行时长限制（通常10秒内），后台时耗时的数据库操作很容易被系统强制终止。

具体解决步骤 #

1. 用WorkManager托管后台数据库任务
   不要直接在onMessageReceived内执行CRUD操作，将任务交给WorkManager处理——它能适配系统后台规则，确保任务在允许的时机执行，即便应用处于后台或进程被杀死。
   示例代码：

   @Override
   public void onMessageReceived(@NonNull RemoteMessage remoteMessage) {
     super.onMessageReceived(remoteMessage);
   
     // 创建单次执行的工作请求
     OneTimeWorkRequest dbWorkRequest = new OneTimeWorkRequest.Builder(DatabaseWorker.class)
         .build();
     // 提交任务到WorkManager
     WorkManager.getInstance(this).enqueue(dbWorkRequest);
   }
   
   // 定义处理数据库操作的Worker类
   public static class DatabaseWorker extends Worker {
     public DatabaseWorker(@NonNull Context context, @NonNull WorkerParameters params) {
       super(context, params);
     }
   
     @NonNull
     @Override
     public Result doWork() {
       // 在这里执行Realtime Database的CRUD操作
       try {
         FirebaseDatabase.getInstance()
             .getReference("test_node")
             .child("test_child")
             .get()
             .addOnCompleteListener(task -> {
               // 处理查询结果
             });
         return Result.success();
       } catch (Exception e) {
         // 执行失败时可重试
         return Result.retry();
       }
     }
   }
   

2. 配置必要的后台权限
   在AndroidManifest.xml中添加对应权限：

   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
   <uses-permission android:name="android.permission.INTERNET" />
   <!-- API 28+ 需添加前台服务权限，确保后台网络操作被允许 -->
   <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
   

   若使用非HTTPS的数据库地址（API 30+），需在application标签内添加：

   <application
       ...
       android:usesCleartextTraffic="true">
       ...
   </application>
   

3. 避免在onMessageReceived内执行耗时操作
   onMessageReceived的执行窗口有限，后台时超出时长会被系统直接终止进程，所有需耗时的操作都要移到独立后台组件中。

4. 更新Firebase依赖版本
   确保Firebase Messaging和Realtime Database的依赖为最新稳定版，旧版本可能存在后台兼容性bug。

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