Flutter 3.16版本iOS应用启动卡白屏问题求助

问题描述 #

将Flutter版本更新至3.16后，所有iOS应用启动时均卡在白屏界面，通过flutter create test_new_project创建的新应用也出现相同问题。flutter doctor检测无异常：

Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.16.0, on macOS 14.1.1 23B81 darwin-arm64, locale
    en-BG)
[✓] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
[✓] Xcode - develop for iOS and macOS (Xcode 15.0.1)
[✓] Chrome - develop for the web
[✓] Android Studio (version 2022.3)
[✓] Android Studio (version 2021.1)
[✓] VS Code (version 1.64.2)
[✓] VS Code (version 1.84.2)
[✓] Connected device (3 available)
[✓] Network resources

• No issues found!

解决步骤 #

• 清理缓存与构建产物
  执行以下命令彻底清理后重新构建：

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

• 检查Xcode构建配置

  1. 打开iOS项目的Runner.xcworkspace，进入Runner target的Build Settings
  2. 将Build Options下的Enable Bitcode设为No
  3. 确认Other Linker Flags包含-ObjC，缺失则手动添加

• 测试Flutter通道兼容性
  尝试切换到beta通道验证是否为版本适配问题：

  flutter channel beta
  flutter upgrade
  

  若问题解决，可等待stable通道修复版本；若依旧，切回原版本：

  flutter channel stable
  flutter downgrade 3.16.0
  

• 查看启动日志定位问题
  通过Xcode运行项目，在Debug Console中查看启动阶段的报错信息，重点关注didFinishLaunchingWithOptions相关输出，排查插件初始化、权限配置等问题。

• 重置iOS模拟器
  打开模拟器后执行Device > Erase All Content and Settings，清除模拟器缓存后重新安装应用测试。

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