升级MacOS Sonoma后Flutter iOS真机调试遇Observatory未发现及发布包崩溃问题

核心原因 #

Flutter 2.8.1为较旧版本，未适配MacOS Sonoma（14.0）和Xcode 15（注：你提到的Xcode 3.0应为笔误，Sonoma对应的最低Xcode版本是15.0）的新特性及API变更，这是导致真机调试时Observatory无法连接、发布包运行崩溃的主要原因。

解决步骤 #

1. 升级Flutter至兼容版本 #

• 升级到支持Sonoma和Xcode 15的Flutter稳定版本（官方推荐3.13及以上）：

  flutter upgrade
  

• 若需指定特定稳定版本，可执行：

  flutter upgrade 3.13.9
  

• 升级后运行flutter doctor，按照提示修复所有环境问题（如Xcode命令行工具配置、开发者证书验证等）

2. 彻底重置iOS项目依赖 #

• 执行Flutter清理命令：

  flutter clean
  

• 进入iOS目录，删除旧依赖文件：

  cd ios
  rm -rf Pods Podfile.lock
  

• 更新本地Pod仓库并重新安装依赖：

  pod repo update
  pod install
  

• 确认Podfile中的iOS部署目标与项目需求一致（例如支持iPhone 6需至少设置platform :ios, '12.0'）

3. 修复Observatory连接问题 #

• 检查设备的开发者证书信任状态：打开iPhone的「设置」>「通用」>「VPN与设备管理」，信任你的开发者证书
• 运行项目时指定Observatory端口，避免端口冲突：

  flutter run --observatory-port 8888
  

• 关闭Mac和iPhone的防火墙，确保设备与电脑的网络通信正常
• 通过Xcode直接运行项目，查看控制台输出的详细错误信息（Xcode顶部菜单「Window」>「Organizer」>「Devices」，选中对应设备查看日志）

4. 解决发布包白屏崩溃问题 #

• 查看Xcode的崩溃日志，定位具体崩溃点（通常是第三方库不兼容或API调用错误）
• 升级项目中所有pub依赖包，确保其支持Xcode 15：

  flutter pub upgrade
  

• 检查Xcode Build Settings：
  • 确保「Architectures」设置为arm64（Xcode 15默认移除32位架构，iPhone 6/12均为arm64架构）
  • 确认「Deployment Target」不低于设备的iOS版本（iPhone 6最低支持iOS 12.0，iPhone 12最低iOS 14.0）
• 重新构建发布包：

  flutter build ios --release
  

  之后通过Xcode归档导出或直接安装到设备测试

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