Flutter集成原生Android Google Map启动空白，多次热重载后恢复

以下是针对问题的实用解决方案：

• 对齐MapView与PlatformView的生命周期
  Google Map的状态依赖Android视图生命周期，必须确保PlatformView的生命周期方法同步MapView的状态：

  public class MapPlatformView implements PlatformView {
      private final MapView mapView;
  
      public MapPlatformView(Context context, int viewId, Map<String, Object> creationParams) {
          mapView = new MapView(context);
          mapView.onCreate(null); // PlatformView无savedInstanceState，传null即可
          mapView.getMapAsync(googleMap -> {
              // 初始化标记、相机位置等业务逻辑
          });
      }
  
      @Override
      public View getView() {
          return mapView;
      }
  
      @Override
      public void onAttachedToWindow() {
          super.onAttachedToWindow();
          mapView.onResume(); // 同步视图resume状态
      }
  
      @Override
      public void onDetachedFromWindow() {
          super.onDetachedFromWindow();
          mapView.onPause();
          mapView.onDestroy(); // 同步视图销毁状态
      }
  
      @Override
      public void dispose() {
          mapView.onDestroy();
      }
  }
  

• 地图加载完成后主动触发重绘
  在MapReady回调中强制触发视图重绘，解决渲染延迟问题：

  mapView.getMapAsync(googleMap -> {
      googleMap.setOnMapLoadedCallback(() -> {
          // 延迟触发重绘，确保视图已就绪
          mapView.post(() -> {
              mapView.invalidate();
              // 额外强制刷新地图类型，触发地图渲染逻辑
              googleMap.setMapType(googleMap.getMapType());
          });
      });
      // 添加标记等业务逻辑
  });
  

• 延迟初始化Flutter端PlatformView
  避免在Widget树未稳定时创建原生视图，用postFrameCallback延迟初始化：

  class MapWidget extends StatefulWidget {
      @override
      State<MapWidget> createState() => _MapWidgetState();
  }
  
  class _MapWidgetState extends State<MapWidget> {
      Widget? _mapView;
  
      @override
      void initState() {
          super.initState();
          // 等待Widget树构建完成后再创建地图视图
          WidgetsBinding.instance.addPostFrameCallback((_) {
              setState(() {
                  _mapView = AndroidView(
                      viewType: 'com.your.package/map_view',
                      creationParams: {},
                      creationParamsCodec: const StandardMessageCodec(),
                  );
              });
          });
      }
  
      @override
      Widget build(BuildContext context) {
          return _mapView ?? const SizedBox.shrink();
      }
  }
  

• 确保地图视图的宽高参数正确
  Android端MapView必须设置MATCH_PARENT布局参数，Flutter端也要给AndroidView设置明确宽高：

  // Android端创建MapView时设置布局参数
  mapView.setLayoutParams(new ViewGroup.LayoutParams(
      ViewGroup.LayoutParams.MATCH_PARENT,
      ViewGroup.LayoutParams.MATCH_PARENT
  ));
  

  // Flutter端用SizedBox包裹确保填充父容器
  SizedBox(
      width: double.infinity,
      height: double.infinity,
      child: _mapView,
  )
  

• 检查Logcat排查初始化日志
  查看Android Studio的Logcat，搜索Google Maps Android API关键词，确认是否有初始化警告或错误（比如密钥权限、服务未启用等问题，虽热重载后正常，但需排除潜在隐患）。

内容的提问来源于stack exchange，提问作者Chup bae