Flutter iOS端flutter run报错：缺失必需模块FirebaseFirestoreInternalWrapper

在Flutter应用中集成Firebase Firestore后，执行flutter run lib/main.dart时抛出Swift编译错误：

Swift Compiler Error (Xcode): Missing required module 'FirebaseFirestoreInternalWrapper'

但通过Xcode直接运行可正常构建启动；Android端无论用Flutter命令还是IDE运行都正常。

已完成的配置步骤：

• 在Flutter代码中添加了await Firebase.initializeApp(options: DefaultFirebaseOptions.currentPlatform);
• 在iOS的AppDelegate中添加了import Firebase和FirebaseApp.configure()

当前Podfile内容如下：

# Uncomment this line to define a global platform for your project
platform :ios, '12.0'

# CocoaPods analytics sends network stats synchronously affecting flutter build latency.
ENV['COCOAPODS_DISABLE_STATS'] = 'true'

project 'Runner', {
  'Debug' => :debug,
  'Profile' => :release,
  'Release' => :release,
}

def flutter_root
  generated_xcode_build_settings_path = File.expand_path(File.join('..', 'Flutter', 'Generated.xcconfig'), __FILE__)
  unless File.exist?(generated_xcode_build_settings_path)
    raise "#{generated_xcode_build_settings_path} must exist. If you're running pod install manually, make sure flutter pub get is executed first"
  end

  File.foreach(generated_xcode_build_settings_path) do |line|
    matches = line.match(/FLUTTER_ROOT\=(.*)/)
    return matches[1].strip if matches
  end
  raise "FLUTTER_ROOT not found in #{generated_xcode_build_settings_path}. Try deleting Generated.xcconfig, then run flutter pub get"
end

require File.expand_path(File.join('packages', 'flutter_tools', 'bin', 'podhelper'), flutter_root)

flutter_ios_podfile_setup

target 'Runner' do
  use_frameworks!
  use_modular_headers!

  flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
  target 'RunnerTests' do
    inherit! :search_paths
  end
end

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
  end
end

需求：无需通过Xcode，直接用Flutter命令运行iOS应用。

尝试以下修复方案，按顺序执行：

1. 彻底清理构建缓存 #

执行以下命令清理Flutter和iOS侧的所有缓存文件：

flutter clean
cd ios
pod deintegrate
pod cache clean --all
rm -rf Podfile.lock .symlinks Flutter/Flutter.framework Flutter/Flutter.podspec
cd ..
flutter pub get
cd ios
pod install
cd ..

完成后再执行flutter run lib/main.dart测试。

2. 修改Podfile的编译配置 #

在Podfile的post_install块中添加针对Firebase依赖的模块强制启用设置：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
    # 给Firebase/Google相关依赖开启模块定义
    if target.name.start_with?('Firebase') || target.name.start_with?('Google')
      target.build_configurations.each do |config|
        config.build_settings['DEFINES_MODULE'] = 'YES'
      end
    end
  end
end

修改后重新执行pod install，再尝试Flutter命令运行。

3. 升级Firebase依赖版本 #

检查pubspec.yaml中Firebase相关包的版本，替换为最新稳定版，示例如下：

dependencies:
  firebase_core: ^2.24.2
  cloud_firestore: ^4.14.0

执行flutter pub upgrade更新依赖，再重复步骤1的缓存清理流程。

4. 切换编译模式测试 #

尝试用Release模式运行，看是否能绕过Debug模式的编译问题：

flutter run --release lib/main.dart

如果Release模式正常，再删除iOS的DerivedData：打开Xcode → 点击顶部菜单Xcode→Preferences→Locations，找到DerivedData路径，删除对应项目的文件夹，回到终端重新执行flutter run。

内容的提问来源于stack exchange，提问作者Thanoss