Android：Firebase推送通知仅Service后台运行时无法持久化，求解决方法

看起来你遇到的核心问题是应用关闭后，后台运行的FirebaseMessagingService里的AsyncTask无法可靠完成通知数据的持久化，这其实和Android后台进程的生命周期限制、AsyncTask的特性密切相关。我来帮你拆解原因并给出可行的解决方案：

问题根源分析 #

1. AsyncTask在后台Service中的不可靠性：当应用关闭后，FirebaseMessagingService所在的进程优先级会大幅降低。AsyncTask依赖主线程Looper运行，如果Service被系统回收，AsyncTask的任务很可能被中断，无法完成持久化操作。
2. SharedPreferences.apply()的异步特性：你在PersistTask中使用了editor.apply()，这是异步写入磁盘的操作。如果进程在写入完成前被系统杀死，数据就会丢失。
3. 额外提醒：FirebaseMessagingService的onMessageReceived方法本身就是在后台线程中调用的，你完全不需要额外开启AsyncTask来执行耗时操作——这反而增加了不可靠性。

解决方案 #

方案1：直接在onMessageReceived中同步执行持久化（最简单可靠） #

既然onMessageReceived已经运行在后台线程，我们可以去掉AsyncTask，直接在这里完成SharedPreferences的写入，并且改用commit()同步写入确保数据落地：

public class NotificationReceiver extends FirebaseMessagingService {
    @Override
    public void onMessageReceived(RemoteMessage remoteMessage) {
        Notification notification = buildNotificationObjet(remoteMessage);
        // 直接在当前后台线程执行保存逻辑
        saveNotificationSync(notification);
        
        if(getPreference("displayNotifications") != 0) {
            sendNotification(remoteMessage.getNotification().getBody());
        }
    }

    private void saveNotificationSync(Notification notification) {
        SharedPreferences preferences = getSharedPreferences(PREFERENCE_NAME, MODE_PRIVATE);
        Gson gson = new Gson();
        Type type = new TypeToken<List<Notification>>(){}.getType();
        
        List<Notification> notifications = gson.fromJson(preferences.getString(PREFERENCE_LIST_NAME, ""), type);
        if(notifications == null) {
            notifications = new ArrayList<>();
        }
        notifications.add(notification);
        
        SharedPreferences.Editor editor = preferences.edit();
        editor.putString(PREFERENCE_LIST_NAME, gson.toJson(notifications));
        // 使用commit()同步写入，确保数据立即落地到磁盘
        editor.commit();
    }
}

方案2：使用WorkManager确保任务可靠执行（适合复杂持久化场景） #

如果后续你的持久化逻辑变得更复杂（比如写入数据库、关联网络请求等），推荐使用Android Jetpack的WorkManager——它能确保任务即使在进程被杀死后也能被执行：

1. 先添加WorkManager依赖（根据你的Gradle版本调整）：

dependencies {
    implementation "androidx.work:work-runtime:2.8.1"
}

2. 创建处理持久化的Worker类：

public class NotificationPersistWorker extends Worker {
    public static final String KEY_NOTIFICATION = "notification";

    public NotificationPersistWorker(@NonNull Context context, @NonNull WorkerParameters params) {
        super(context, params);
    }

    @NonNull
    @Override
    public Result doWork() {
        // 从任务参数中获取通知数据
        String notificationJson = getInputData().getString(KEY_NOTIFICATION);
        if(notificationJson == null) {
            return Result.failure();
        }
        
        Gson gson = new Gson();
        Notification notification = gson.fromJson(notificationJson, Notification.class);
        
        SharedPreferences preferences = getApplicationContext().getSharedPreferences(PREFERENCE_NAME, MODE_PRIVATE);
        Type type = new TypeToken<List<Notification>>(){}.getType();
        
        List<Notification> notifications = gson.fromJson(preferences.getString(PREFERENCE_LIST_NAME, ""), type);
        if(notifications == null) {
            notifications = new ArrayList<>();
        }
        notifications.add(notification);
        
        SharedPreferences.Editor editor = preferences.edit();
        editor.putString(PREFERENCE_LIST_NAME, gson.toJson(notifications));
        editor.commit();
        
        return Result.success();
    }
}

3. 在FirebaseMessagingService中提交WorkManager任务：

public class NotificationReceiver extends FirebaseMessagingService {
    @Override
    public void onMessageReceived(RemoteMessage remoteMessage) {
        Notification notification = buildNotificationObjet(remoteMessage);
        // 将通知转为JSON字符串，传入Worker
        Gson gson = new Gson();
        String notificationJson = gson.toJson(notification);
        
        // 创建一次性任务请求
        OneTimeWorkRequest workRequest = new OneTimeWorkRequest.Builder(NotificationPersistWorker.class)
                .setInputData(new Data.Builder()
                        .putString(NotificationPersistWorker.KEY_NOTIFICATION, notificationJson)
                        .build())
                .build();
        
        // 提交任务到WorkManager
        WorkManager.getInstance(this).enqueue(workRequest);
        
        if(getPreference("displayNotifications") != 0) {
            sendNotification(remoteMessage.getNotification().getBody());
        }
    }
}

关键注意点 #

• 避免在后台Service中使用AsyncTask：Android 12及以上对后台Service的限制更严格，AsyncTask这种依赖主线程的组件在后台场景下极易出现任务中断。
• 优先用同步写入保证可靠性：对于SharedPreferences，commit()虽然会阻塞当前线程，但在后台线程中执行完全没问题，能确保数据立即写入磁盘。
• 复杂场景选WorkManager：它是Google官方推荐的后台任务管理组件，能适配各Android版本的后台限制，保证任务最终被执行。

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