You need to enable JavaScript to run this app. 使用google_maps_flutter切换页面出现MissingPluginException异常如何解决?
优惠活动
大模型
产品
解决方案
定价
更多

使用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.17 23:45:07