Flutter打包IPA报错：using bridging headers with module interfaces is unsupported

针对错误：error: using bridging headers with module interfaces is unsupported #

• 调整Xcode项目Build Settings：

  1. 打开iOS项目的Build Settings，找到Swift Compiler - General分类
  2. 将Enable Module Interfaces设置为NO（归档模式下该选项默认开启，会与桥接文件产生冲突）
  3. 确认Objective-C Bridging Header的路径正确性，需使用相对项目根目录的路径，例如Runner/Runner-Bridging-Header.h

• 清理缓存并重新构建：
  执行以下命令清理Flutter、Pods及Xcode缓存：

  flutter clean
  cd ios
  pod deintegrate
  pod install
  rm -rf ~/Library/Developer/Xcode/DerivedData
  

针对错误：SwiftDriver compilation error: com.apple.xcode.tools.swift.compiler is not absolute #

• 修复Xcode命令行工具路径：

  1. 终端执行xcode-select -p，确认输出为绝对路径（如/Applications/Xcode.app/Contents/Developer）
  2. 若路径异常，执行sudo xcode-select -s /Applications/Xcode.app/Contents/Developer（替换为你的Xcode实际安装路径）

• 校准Fastlane环境配置：

  1. 在Fastfile中添加Xcode路径指定：

     xcode_select "/Applications/Xcode.app"
     

  2. 确保使用稳定版Xcode（Flutter 3.13.5建议搭配Xcode 15.x稳定版，避免beta版本的兼容性问题）

额外排查项 #

• 升级所有Flutter插件至兼容3.13.5的版本，重点检查涉及Swift与OC混编的第三方依赖
• 尝试用Xcode手动归档，排除Fastlane脚本参数冲突；若手动归档正常，可将Podfile中的use_modular_headers!改为use_frameworks! :linkage => :static（Flutter 3.10+推荐静态框架配置）

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