Flutter-Firebase iOS应用构建报错：Module 'firebase_core'未找到

开发者阿泽

2026-8-10

解决iOS模拟器构建Module 'firebase_core' not found报错

下面是几个针对性的解决步骤，按顺序尝试即可：

1. 彻底清理构建缓存

先把旧的构建产物和Pod依赖清干净，重新生成：

项目根目录执行：
```
flutter clean
```

进入iOS目录，清理Pod相关文件：

cd ios
pod deintegrate
pod clean
rm Podfile.lock

重新安装Pods并运行：
```
pod install
cd ..
flutter run
```

2. 修正Podfile配置适配SPM

虽然Firebase现在推荐SPM，但Flutter插件大多还是依赖CocoaPods管理，修改ios/Podfile：

# 在target 'Runner'块之前添加指定Firebase版本（和你pubspec里的firebase_core对应版本匹配）
$FirebaseSDKVersion = '10.0.0'

target 'Runner' do
  use_frameworks!
  use_modular_headers!

  flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
end

改完后重新执行pod install，再构建项目。

3. 修复GeneratedPluginRegistrant的注册错误

看你提供的代码里，最后一行注册SharedPreferences插件时写错了插件名称：
原错误代码：

[FLTSharedPreferencesPlugin registerWithRegistrar:[registry registrarForPlugin:@"FLTFirebaseCorePlugin"]];

修正为：

[FLTSharedPreferencesPlugin registerWithRegistrar:[registry registrarForPlugin:@"FLTSharedPreferencesPlugin"]];

这个错误会干扰依赖解析，修正后重新构建。

4. 调整Firebase初始化顺序

把AppDelegate.swift里的初始化顺序调换，先初始化Firebase再注册插件：

import UIKit
import Flutter
import FirebaseCore

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
  override func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
  ) -> Bool {
    FirebaseApp.configure()
    GeneratedPluginRegistrant.register(with: self)
      
    return super.application(application, didFinishLaunchingWithOptions: launchOptions)
  }
}