You need to enable JavaScript to run this app. Flutter基于RepaintBoundary的Google地图自定义Marker仅热重启后显示异常
优惠活动
大模型
产品
解决方案
定价
更多

Flutter基于RepaintBoundary的Google地图自定义Marker仅热重启后显示异常

问题根因定位
  • 时序错配:_onMapCreated 中先通过setState将_opacity_num设为0,紧接着同步调用_addMarker(),此时UI重建流程尚未完成,RepaintBoundary对应的渲染节点还没走完绘制流程,调用截图逻辑时拿到的是未完成渲染的对象,生成的图标自然无效。
  • 异步资源加载缺失等待:代码中使用的AssetImage是异步加载机制,截图时如果图片资源还没完成加载渲染,RepaintBoundary截取到的是空内容,生成的Marker图标无有效像素。
  • 空值校验缺失:_getMarkerIconBytes返回null/空数据时没有做拦截,直接传入BitmapDescriptor.fromBytes生成无效Marker,这类Marker不会被地图组件渲染。
  • 热重启时可以正常显示的本质原因是:热重启流程下整个Widget树初始化节奏更慢,等所有资源加载、绘制流程走完时才生成Marker图标,拿到的字节数据是正常的,规避了上述时序问题。
具体修复方案
  • 将离屏渲染的RepaintBoundary设为永久隐藏,无需通过动态opacity控制可见性,从根源上消除绘制时序依赖:这个组件本身就是用来生成Marker图标的,不需要让用户看到,固定设为0透明度即可从第一帧开始后台正常渲染。
  • 预加载Asset图片资源,等资源加载完成、RepaintBoundary绘制完成后再生成Marker图标字节。
  • 增加渲染状态校验、空数据拦截,避免无效Marker被添加到地图集合中。
  • 解耦Marker生成逻辑和地图初始化回调,不要把截图逻辑绑定在onMapCreated的同步执行流程里。
修正后的核心实现代码

首先移除冗余的_opacity_num动态变化逻辑,调整build方法:

@override
Widget build(BuildContext context) {
  return Scaffold(
    body: SafeArea(
      child: Stack(
        children: [
          // 离屏渲染的Marker图标永久隐藏,不随回调变化
          Opacity(
            opacity: 0,
            child: _buildMarkerIcon(),
          ),
          Opacity(
            opacity: 1,
            child: _buildBody(),
          ),
        ],
      ),
    ),
    floatingActionButton: FloatingActionButton(
      child: const Icon(Icons.zoom_out_map),
      onPressed: _centerView,
    ),
  );
}

调整State中的初始化和Marker生成逻辑:

@override
void initState() {
  super.initState();
  _markerIconKey = GlobalKey();
  // 预加载图片资源,等资源完全加载后再生成Marker
  precacheImage(const AssetImage('imagenes/Junior_logo.png'), context).then((_) {
    // 等第一帧UI绘制完成后执行截图逻辑
    WidgetsBinding.instance.addPostFrameCallback((_) {
      _generateMarkerIcon();
    });
  });
}

Future<void> _generateMarkerIcon() async {
  // 校验RepaintBoundary是否已经完成渲染
  if (_markerIconKey.currentContext == null) return;
  final boundary = _markerIconKey.currentContext!.findRenderObject() as RenderRepaintBoundary;
  // 若组件还未完成绘制,延迟重试
  if (boundary.debugNeedsPaint) {
    await Future.delayed(const Duration(milliseconds: 50));
    return _generateMarkerIcon();
  }

  final image = await boundary.toImage(pixelRatio: 2.0);
  final byteData = await image.toByteData(format: ImageByteFormat.png);
  // 空数据直接拦截,不生成无效Marker
  if (byteData == null) return;
  final markerBytes = byteData.buffer.asUint8List();

  setState(() {
    _markers.add(
      Marker(
        markerId: const MarkerId(IdTacosSauces),
        position: Constants.kTacosLocationSauces,
        icon: BitmapDescriptor.fromBytes(markerBytes),
      ),
    );
  });
}

// onMapCreated中只做地图实例绑定,不再触发Marker生成逻辑
void _onMapCreated(GoogleMapController controller) {
  _mapController = controller;
  _centerView();
}

额外校验提示:如果boundary.toImage返回的图像尺寸为0,同样会生成无效Marker,可在代码中增加图像宽高的判断,进一步降低异常概率。


内容的提问来源于stack exchange,提问作者PartnerTech

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.27 06:06:03