使用google_maps_flutter切换页面出现MissingPluginException异常如何解决?
这个错误的核心原因是谷歌地图Widget已被销毁(如切换页面触发组件卸载)后,仍有未执行完成的异步操作尝试调用已经被释放的平台通道,Android端插件的通道释放时机更早,所以仅在Android侧复现。修复方案如下:
修复方案
1. 增加挂载状态判断
定义布尔变量标记组件的存活状态,所有和地图控制器相关的操作执行前先做状态校验,避免操作已销毁的对象:
// 页面状态中新增变量 bool _isMapMounted = true; final Completer<GoogleMapController> _googleMapController = Completer(); Set<Marker> _markers = {}; @override void dispose() { // 组件销毁时标记为未挂载 _isMapMounted = false; super.dispose(); }
修改你的GoogleMap配置代码:
String id = "id"; BitmapDescriptor pinLocationIcon; // 已正常初始化可展示 GoogleMap( mapType: MapType.normal, markers: _markers, initialCameraPosition: CameraPosition( target: LatLng(<替换为实际纬度>, <替换为实际经度>), zoom: 15, ), onMapCreated: (GoogleMapController controller) { // 先校验组件是否还存活、控制器是否已完成初始化 if (!_isMapMounted || _googleMapController.isCompleted) return; _googleMapController.complete(controller); // setState前也校验mounted状态,避免销毁后触发页面更新 if (mounted) { setState(() { _markers.add(Marker( markerId: MarkerId(this.id), position: LatLng(<替换为实际纬度>, <替换为实际经度>), icon: pinLocationIcon, )); }); } }, )
后续所有调用地图控制器的逻辑都需要先做状态校验:
Future<void> operateMap() async { // 先校验状态再执行操作 if (!_isMapMounted || !_googleMapController.isCompleted) return; final GoogleMapController controller = await _googleMapController.future; // 执行其他地图操作,如移动视角、更新标记等 }
2. 补充混淆规则(Release包场景)
如果你的Android打包开启了R8混淆,需要在android/app/proguard-rules.pro文件中新增谷歌地图插件的保留规则,避免相关类被混淆删除:
-keep class io.flutter.plugins.googlemaps.** { *; } -keep class com.google.maps.android.** { *; }
3. 升级插件版本
当前错误属于google_maps_flutter低版本的已知问题,升级插件到最新稳定版即可修复原生侧通道释放的逻辑缺陷。如果升级后仍有问题,可选择给地图页面混入AutomaticKeepAliveClientMixin,避免页面切换时地图被频繁销毁重建。
内容的提问来源于stack exchange,提问作者bshelbourne15
相关产品推荐
相关产品推荐

