Flutter应用在macOS启动黑屏且致系统崩溃求助

问题现象 #

• macOS启动Flutter应用后仅显示黑屏
• 触发系统panic，伴随屏幕黑点、画面串屏、设备发热，控制台无规律报错
• 已确认：参考GitHub Issue #125025无效；开启/关闭调试器启动均无效；Flutter Doctor检测无异常；应用在Chrome、Windows 11端可正常运行

排查与修复建议 #

• 重置Flutter构建缓存
  执行以下命令彻底清理缓存后重新构建：

  flutter clean
  rm -rf .dart_tool
  rm -rf build
  flutter pub get
  flutter run -d macos
  

• 切换Flutter SDK版本
  当前SDK版本可能存在macOS适配bug，先切换到稳定版最新版：

  flutter channel stable
  flutter upgrade
  

  若无效，回退到已知稳定的旧版本（如3.13.x系列）：

  flutter downgrade 3.13.9
  

• 更新macOS系统与显卡驱动
  前往「系统设置-通用-软件更新」安装所有可用更新，包括显卡相关补丁；若使用外接显示器，断开后仅用内置屏幕测试。

• 禁用硬件加速
  在macos/Runner/AppDelegate.swift中添加禁用硬件加速的代码：

  import Cocoa
  import FlutterMacOS
  
  @NSApplicationMain
  class AppDelegate: FlutterAppDelegate {
    override func applicationShouldTerminateAfterLastWindowClosed(_ sender: NSApplication) -> Bool {
      return true
    }
    
    override func applicationDidFinishLaunching(_ aNotification: Notification) {
      FlutterViewController.setMetalEnabled(false)
      super.applicationDidFinishLaunching(aNotification)
    }
  }
  

  重新编译运行测试。

• 验证最小化项目
  新建空白项目测试：

  flutter create test_mac_app
  cd test_mac_app
  flutter run -d macos
  

  若仍异常，说明是本地环境问题；若正常，排查原项目的代码或依赖冲突。

• 排查第三方依赖
  逐一移除项目中的第三方依赖，运行测试定位问题依赖；执行flutter pub outdated查看依赖更新，尝试更新到稳定版本。

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