You need to enable JavaScript to run this app. iOS开发FCM编译报错Cannot find type 'MessagingRemoteMessage' in scope如何解决
优惠活动
大模型
产品
解决方案
定价
更多

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。

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.05 19:54:03