iOS开发FCM编译报错Cannot find type 'MessagingRemoteMessage' in scope如何解决
iOS端FCM编译找不到
MessagingRemoteMessage类型的修复方案 报错场景
项目集成FCM推送功能时,AppDelegate中实现MessagingDelegate协议的代码触发编译错误,构建中断,报错信息为:Cannot find type 'MessagingRemoteMessage' in scope
报错原因
该问题是Firebase Messaging SDK迭代带来的API破坏性变更导致:
自Firebase iOS SDK 10.0.0版本起,旧的MessagingRemoteMessage类型、对应的messaging(_:didReceive:)回调方法被完全废弃并从公开头文件中移除,只要代码中保留对这个旧类型的引用,就会触发类型找不到的编译失败。
修复步骤
- 不要通过锁低版本SDK、修改SDK源码的方式强行找回已移除的
MessagingRemoteMessage类型,这类操作很容易引发和其他Firebase模块的版本兼容冲突。 - 删除代码中已经失效的旧消息回调方法,替换为新版SDK对应的协议实现。
旧的失效代码片段:// 该API已被SDK移除,无法通过编译 func messaging(_ messaging: Messaging, didReceive remoteMessage: MessagingRemoteMessage) { print("Received data message: \(remoteMessage.appData)") } - 完整修正后的
AppDelegate代理实现参考:extension AppDelegate: MessagingDelegate { // [START refresh_token] func messaging(_ messaging: Messaging, didReceiveRegistrationToken fcmToken: String?) { print("Firebase registration token: \(fcmToken)") let dataDict: [String: String?] = ["token": fcmToken] NotificationCenter.default.post(name: Notification.Name("FCMToken"), object: nil, userInfo: dataDict) // 每次App启动、FCM token重新生成时都会触发该回调 } // 新版SDK对应的远程消息接收回调 func messaging(_ messaging: Messaging, didReceive message: any MessagingMessage) { print("Received data message: \(message.data)") } } - 代码修正完成后,如果是CocoaPods集成的项目,重新执行
pod install同步依赖;通过Xcode的Product -> Clean Build Folder功能清理编译缓存后,重新构建项目即可解决问题。
补充说明:如果替换代码后仍报类型识别错误,检查对应文件顶部的模块引用,确认已经添加
import FirebaseCore、import FirebaseMessaging,避免因缺模块引用引发同类编译报错。
内容的提问来源于stack exchange,提问作者Jack。
相关产品推荐
相关产品推荐

