Mac M3搭建Flutter项目遇iOS编译错误：__swift_FORCE_LOAD_符号未定义

问题环境 #

• 设备：Mac M3
• macOS版本：Sonoma 14.7 (23H124)
• Xcode版本：15.4
• Flutter版本：3.22.2

错误信息 #

Running Xcode build...                                                   
 └─Compiling, linking and signing...                      2,794ms
Xcode build done.                                           36.8s
Failed to build iOS app
Error (Xcode): Undefined symbol: __swift_FORCE_LOAD_$_swift_Builtin_float


Error (Xcode): Undefined symbol: __swift_FORCE_LOAD_$_swift_errno


Error (Xcode): Undefined symbol: __swift_FORCE_LOAD_$_swift_math


Error (Xcode): Undefined symbol: __swift_FORCE_LOAD_$_swift_signal


Error (Xcode): Undefined symbol: __swift_FORCE_LOAD_$_swift_stdio


Error (Xcode): Undefined symbol: __swift_FORCE_LOAD_$_swift_time


Error (Xcode): Undefined symbol: __swift_FORCE_LOAD_$_swiftsys_time


Error (Xcode): Undefined symbol: __swift_FORCE_LOAD_$_swiftunistd


Error (Xcode): Linker command failed with exit code 1 (use -v to see
invocation)


Could not build the application for the simulator.
Error launching application on iPhone 15 Pro Max.

解决方案 #

1. 升级Flutter版本 #

Flutter 3.22.2对Xcode 15.4的兼容性不足，建议升级到3.24.0及以上版本：

flutter upgrade

2. 调整Xcode项目Swift编译配置 #

1. 打开iOS目录下的Runner.xcworkspace
2. 选中Runner目标，进入Build Settings
3. 搜索Always Embed Swift Standard Libraries，设置为YES
4. 搜索Swift Language Version，选择5.9及以上的兼容版本

3. 彻底清理缓存后重建 #

执行以下命令清理所有缓存文件，再重新构建项目：

flutter clean
rm -rf ios/Pods ios/Podfile.lock
rm -rf ~/Library/Developer/Xcode/DerivedData
flutter pub get
cd ios && pod install
cd .. && flutter run

4. 更新第三方Pod依赖 #

部分依赖库可能未适配Xcode 15.4，执行命令更新Pods：

cd ios
pod repo update
pod update

5. 对齐Xcode命令行工具版本 #

确保命令行工具与当前Xcode版本一致：

xcode-select --print-path
# 若路径不符，执行：
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer

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