运行GeoFlutterFire示例出现GoogleMapController延迟初始化错误如何解决

LateInitializationError错误的本质是：你使用late关键字修饰的_mapController变量，在build方法执行访问它的时候，还没有完成赋值操作。仅修改修饰符（加late、同时加final+late）都无法解决问题，必须保证变量在被访问前完成初始化。

GoogleMapController无法在initState阶段直接初始化，必须依赖GoogleMap组件加载完成后的回调赋值，具体操作如下：

1. 先在initState中初始化不需要依赖视图渲染的文本编辑控制器

class _MyAppState extends State<MyApp> {
  late GoogleMapController _mapController;
  late TextEditingController _latitudeController, _longitudeController;

  @override
  void initState() {
    super.initState();
    _latitudeController = TextEditingController();
    _longitudeController = TextEditingController();
  }
}

2. 利用GoogleMap组件的onMapCreated回调完成地图控制器赋值

@override
Widget build(BuildContext context) {
  return Scaffold(
    body: GoogleMap(
      // 地图加载完成后会自动触发该回调，拿到控制器实例
      onMapCreated: (GoogleMapController controller) {
        _mapController = controller;
      },
      // 保留你原本的其他地图配置项
      initialCameraPosition: const CameraPosition(
        target: LatLng(39.9042, 116.4074),
        zoom: 12,
      ),
    ),
  );
}

3. 避免提前访问_mapController
   如果你需要在build阶段就调用地图控制器的方法（比如移动相机、添加标记），可以选择两种优化方案：

• 方案一：将late声明改为可空类型，访问前判空

// 声明改为可空，去掉late
GoogleMapController? _mapController;

// 调用时先判断是否完成初始化
if (_mapController != null) {
  _mapController!.moveCamera(CameraUpdate.newLatLng(const LatLng(30, 120)));
}

• 方案二：新增地图加载完成标记，控制渲染逻辑

// 新增状态标记
bool _mapLoaded = false;

// 在onMapCreated中更新标记
onMapCreated: (GoogleMapController controller) {
  _mapController = controller;
  setState(() {
    _mapLoaded = true;
  });
}

// build阶段根据标记判断是否可以调用控制器
body: _mapLoaded 
    ? // 渲染需要用到地图控制器的逻辑
    : const Center(child: CircularProgressIndicator()),

在页面销毁时要及时释放控制器，避免内存泄漏：

@override
void dispose() {
  _latitudeController.dispose();
  _longitudeController.dispose();
  _mapController.dispose();
  super.dispose();
}

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