Flutter iOS 14编译报错：FirebaseSessions非模块化头文件引入问题

问题原因 #

FirebaseSessions框架内部引入了nanopb的头文件，但nanopb默认未启用模块化头编译，导致Swift编译器无法识别这些头文件所属的模块化框架，从而抛出编译错误。

具体解决方案 #

调整Podfile配置，为nanopb和FirebaseSessions明确开启模块化头支持，步骤如下：

1. 修改iOS目录下的Podfile，在现有Firebase相关pod声明后添加：

pod 'nanopb', :modular_headers => true
pod 'FirebaseSessions', :modular_headers => true

修改后的相关片段示例：

pod 'Firebase', :modular_headers => true
pod 'FirebaseCore', :modular_headers => true
pod 'GoogleUtilities', :modular_headers => true
pod 'nanopb', :modular_headers => true
pod 'FirebaseSessions', :modular_headers => true

2. 执行完整的清理与重装流程：

# 清理Flutter项目缓存
flutter clean

# 进入iOS目录
cd ios

# 完全移除现有Pods依赖
pod deintegrate

# 重新安装Pods
pod install

# 返回项目根目录，更新Flutter依赖
cd ..
flutter pub get

3. （可选）若上述步骤无效，尝试切换为静态框架链接（Flutter 2.5+推荐）：
   在target 'Runner' do块内，将use_frameworks!替换为：

use_frameworks! :linkage => :static

然后重复第2步的清理重装操作。

原理说明 #

通过为nanopb和FirebaseSessions开启:modular_headers => true，会强制CocoaPods为这些框架生成合规的模块化头文件结构，让Swift编译器能正确识别框架内的头文件引用，彻底消除非模块化头的编译报错。

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