iOS 17中通过Pod集成Flutter页面白屏问题求解

核心排查与修复步骤 #

• 调整Flutter引擎初始化时机
  旧项目可能过早初始化Flutter引擎（比如在application:didFinishLaunchingWithOptions:之前），iOS 17对UI线程调度的限制更严格，会导致渲染资源被抢占。建议将引擎初始化延迟到首次跳转Flutter页面的前一刻执行，避免提前占用UI线程资源。
• 验证自定义FlutterViewController的兼容性
  你的MyFlutterViewController可能存在iOS 17适配问题，先替换为原生FlutterViewController测试：

  self.flutterVC = [[FlutterViewController alloc] initWithEngine:app.flutterEngine nibName:nil bundle:nil];
  [vc presentViewController:self.flutterVC animated:YES completion:nil];
  

  如果原生控制器能正常显示，说明自定义类的viewDidLoad/loadView方法破坏了Flutter渲染流程，检查是否在iOS 17下修改了视图层级或渲染优先级。
• 更新Flutter与Pod依赖
  旧版本Flutter未适配iOS 17特性，执行以下命令更新：

  flutter upgrade
  cd ios
  pod deintegrate
  pod install
  

  确保Podfile中指定的Flutter版本为3.13及以上的稳定版，该版本已针对iOS 17做适配。
• 检查Info.plist配置
  iOS 17对权限与渲染配置的要求更严格，确认Info.plist中：
  • 未强制关闭硬件加速相关配置
  • 若使用原生嵌入Flutter视图，io.flutter.embedded_views_preview已设为YES
  • 没有错误的NSAppTransportSecurity规则阻止Flutter资源加载
• 排查UI线程阻塞
  iOS 17对UI线程卡顿的容忍度更低，旧项目跳转Flutter页面时可能存在同步耗时操作（比如布局计算、同步网络请求）。用Xcode Instruments的Time Profiler工具检查跳转时的UI线程占用，将耗时操作改为异步执行。

额外对比验证 #

• 对比新旧项目的Podfile配置，排查是否有第三方SDK与Flutter的渲染逻辑冲突
• 在旧项目中新建一个空白Target，按照新项目的集成流程接入Flutter，逐步定位旧项目中的配置差异

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