Flutter 3.3.10中fluttertoast报错求助：Overlay.maybeOf未找到

问题原因 #

Flutter 3.3.x版本的Overlay类尚未提供maybeOf静态方法，该方法是Flutter 3.7.0及以上版本才新增的API。而fluttertoast 8.1.x及后续版本的源码中使用了这个新方法，导致与低版本Flutter不兼容，即使更换同系列小版本也无法解决。

可行解决方案 #

方案一：降级fluttertoast到兼容版本

选择适配Flutter 3.3.x的fluttertoast版本，推荐8.0.9（该版本使用Overlay.of而非maybeOf）：

• 打开项目根目录的pubspec.yaml，修改依赖配置：

  fluttertoast: ^8.0.9
  

• 执行命令更新依赖：

  flutter pub get
  

• 清理项目缓存后重新运行：

  flutter clean
  flutter run
  

方案二：临时修改fluttertoast源码（不推荐，pub get会覆盖）

如果暂时不想降级或升级，可直接修改本地缓存的fluttertoast代码：

• 定位到报错文件：../flutter/.pub-cache/hosted/pub.dartlang.org/fluttertoast-[你的版本号]/lib/fluttertoast.dart
• 将第165行的代码：

  var _overlay = Overlay.maybeOf(context!);
  

  替换为兼容低版本的写法：

  var _overlay = Overlay.of(context!, rootOverlay: true);
  

• 重新运行项目

方案三：升级Flutter版本（推荐，长期解决）

如果项目允许，将Flutter升级到3.7.0及以上版本，即可直接支持Overlay.maybeOf方法，使用最新版fluttertoast：

• 执行升级命令：

  flutter upgrade
  

• 重新拉取依赖并运行项目

注意事项 #

若更换版本后仍报错，大概率是pub缓存残留问题，需清理缓存后重试：

flutter pub cache clean
flutter pub get
flutter clean
flutter run

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