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
相关产品推荐
相关产品推荐

