如何在FirebaseMessagingService收到消息时向当前可见Activity展示Fragment？

FirebaseMessagingService属于无UI的后台组件，本身不持有任何Activity上下文，而Fragment必须绑定到具体Activity的FragmentManager才能完成加载、展示，因此完全无法在Service内部直接完成Fragment的弹出操作。正确的实现路径是：

• 全局实时追踪对用户可见的前台Activity实例
• FCM收到消息时，优先判断应用是否处于前台（是否存在有效可见Activity）
• 由前台的可见Activity完成Fragment的加载和展示

1. 全局追踪可见Activity #

在自定义的Application类中注册系统提供的Activity生命周期回调，全程记录栈顶当前和用户交互的Activity，不需要逐页修改业务Activity的代码：

public class AppController extends Application {
    // 用弱引用持有Activity，避免内存泄漏
    public static WeakReference<Activity> foregroundActivity;

    @Override
    public void onCreate() {
        super.onCreate();
        registerActivityLifecycleCallbacks(new ActivityLifecycleCallbacks() {
            @Override
            public void onActivityCreated(@NonNull Activity activity, @NonNull Bundle savedInstanceState) {}

            @Override
            public void onActivityStarted(@NonNull Activity activity) {
                foregroundActivity = new WeakReference<>(activity);
            }

            @Override
            public void onActivityResumed(@NonNull Activity activity) {
                // 栈切换时同步更新当前获得焦点的Activity
                foregroundActivity = new WeakReference<>(activity);
            }

            @Override
            public void onActivityPaused(@NonNull Activity activity) {
                // 如果当前Activity失焦，清空引用避免拿到无效实例
                if (foregroundActivity != null && foregroundActivity.get() == activity) {
                    foregroundActivity = null;
                }
            }

            // 其余生命周期回调为空实现即可
            @Override public void onActivityStopped(@NonNull Activity activity) {}
            @Override public void onActivitySaveInstanceState(@NonNull Activity activity, @NonNull Bundle outState) {}
            @Override public void onActivityDestroyed(@NonNull Activity activity) {}
        });
    }
}

2. 修改FCM Service的消息处理逻辑 #

在原有Service的onMessageReceived方法中，拿到消息数据后校验当前前台Activity的有效性，再触发Fragment加载：

@Override
public void onMessageReceived(@NonNull RemoteMessage remoteMessage) {
    if (remoteMessage.getData().size() > 0) {
        Map<String, String> msgData = remoteMessage.getData();
        Log.d(TAG, "Message data payload: " + msgData);

        // 校验是否存在有效前台Activity
        if (AppController.foregroundActivity != null) {
            Activity visibleActivity = AppController.foregroundActivity.get();
            // 排除Activity已销毁、正在关闭的无效状态
            if (visibleActivity != null 
                && !visibleActivity.isFinishing() 
                && !visibleActivity.isDestroyed()) {
                
                // Fragment操作必须切到主线程执行
                visibleActivity.runOnUiThread(() -> {
                    // 替换成你已经写好的底部Fragment，传入消息数据
                    YourBottomNotificationFragment fragment = 
                        YourBottomNotificationFragment.newInstance(msgData);
                    
                    // 走标准Fragment事务展示
                    FragmentManager fragmentManager = 
                        visibleActivity.getSupportFragmentManager();
                    fragment.show(fragmentManager, "bottom_notification_tag");
                });
            }
        } else {
            // 应用在后台时不要强制弹UI，直接走系统通知的常规逻辑
            // 后台弹UI会被安卓高版本系统直接拦截
        }
    }
}

• 必须用弱引用持有Activity，不要用强静态引用，否则会造成Activity无法被回收，长期运行引发内存泄漏
• 操作Fragment事务前必须校验Activity的有效状态，否则容易触发Can not perform this action after onSaveInstanceState的崩溃
• 如果你的项目已经接入了EventBus、Flow、全局LiveData这类通信组件，可以替换掉全局Activity追踪的逻辑：FCM收到消息时发送全局事件，每个Activity在自身onResume状态下监听事件，收到后自行弹Fragment，这种方式的代码耦合度更低
• 安卓10及以上版本严格限制后台应用启动UI组件，应用在后台时不要尝试弹Fragment，否则会被系统直接拦截，没有任何展示效果

内容的提问来源于stack exchange，提问作者S. Joshi