Flutter firebase_messaging ^9.1.0版本configure方法调用异常求助
问题核心说明
你当前调用firebaseMessaging.configure()触发异常的根本原因是:firebase_messaging 9.1.0版本已经彻底废弃并移除了该旧方法。在9.0.0大版本迭代时,官方就将原本集中在configure里的回调逻辑,拆分成了独立的流监听接口,你现在的代码本质仍在使用8.x及更早版本的旧API,和当前依赖版本完全不匹配,自然会报错。
很多人按照文档迁移时没注意到API的拆分逻辑,只改了部分代码就以为适配完成,最后还是会触发接口不存在的异常。
新旧API对应关系
原configure方法封装的三个回调场景,在新版本中分别对应以下独立接口:
- 原
onMessage:应用处于前台时收到推送,替换为firebaseMessaging.onMessage流监听 - 原
onResume:应用处于后台时,用户点击通知唤起应用,替换为firebaseMessaging.onMessageOpenedApp流监听 - 原
onLaunch:应用被完全终止时,用户点击通知冷启动打开应用,替换为firebaseMessaging.getInitialMessage()方法的一次性初始化调用
可直接替换的代码实现
class PushNotificationService { final FirebaseMessaging firebaseMessaging = FirebaseMessaging.instance; Future initialize(context) async { if (Platform.isIOS) { // 权限请求是异步流程,需要加await保证执行顺序 await firebaseMessaging.requestPermission( alert: true, announcement: false, badge: true, carPlay: false, criticalAlert: false, provisional: false, sound: true, ); } // 对应原configure的onMessage:前台收到推送的处理逻辑 firebaseMessaging.onMessage.listen((RemoteMessage message) { fetchRideInfo(getRideID(message), context); }); // 对应原configure的onResume:后台点击通知唤起的处理逻辑 firebaseMessaging.onMessageOpenedApp.listen((RemoteMessage message) { fetchRideInfo(getRideID(message), context); }); // 对应原configure的onLaunch:冷启动时点击通知的处理逻辑 RemoteMessage? initialMessage = await firebaseMessaging.getInitialMessage(); if (initialMessage != null) { fetchRideInfo(getRideID(initialMessage), context); } } }
迁移常见踩坑点
- 新版本的消息对象类型已经从旧版的
Map<String, dynamic>替换为RemoteMessage类,你现有的getRideID方法需要同步调整入参类型,否则会触发类型不匹配的报错 - 如果需要处理应用完全在后台运行时收到的数据类推送,必须单独声明一个顶层的消息处理回调,不能将该回调写在类内部(Dart的隔离机制不允许非顶层函数作为后台消息处理器)
- 不要省略权限请求的
await,否则容易出现权限弹窗还没走完流程,后续的消息监听已经提前初始化,导致前台收不到推送的问题
内容的提问来源于stack exchange,提问作者IBRAHIM ALI MUSAH
相关产品推荐
相关产品推荐

