Flutter中Google Maps相机无法加载已保存LatLng坐标的问题排查

我尝试在Flutter的edit_address.dart页面中，将Google Map组件的相机位置初始化到自定义AddressObject对象中保存的经纬度坐标。在initState生命周期方法中调用getSavedLocation方法后，相机始终停留在(0,0)位置。

错误原因分析 #

• 控制器初始化时机不匹配：getSavedLocation在initState中调用时，GoogleMap的_googleMapController还未被初始化（控制器在onMapCreated回调中才会赋值），此时直接调用_googleMapController!.animateCamera会触发空指针异常或无效果，因为控制器实例还不存在。
• 初始相机位置未更新：_cameraPosition初始值是(0,0)，且在获取到已保存坐标后没有更新这个变量，导致GoogleMap始终以(0,0)作为初始位置加载。
• 异步方法调用不当：在setState中直接调用异步方法getAddress，会导致UI更新时机混乱，无法保证地址数据正确更新到文本控制器。
• 冗余的权限检查：加载已保存的坐标不需要定位权限，当前代码中的权限检查逻辑会阻塞坐标初始化流程，甚至可能因权限问题提前返回，导致后续的坐标赋值和相机更新代码无法执行。

修复方案 #

1. 直接在initState中初始化坐标与相机位置：无需等待异步方法，直接从widget.editingAddress读取经纬度，初始化_latlong和_cameraPosition，让GoogleMap加载时直接使用正确的初始位置。
2. 调整控制器动画逻辑：在onMapCreated回调中，确认控制器初始化完成后，再执行相机动画（可选，因为初始位置已正确设置）。
3. 修正异步方法调用：将getAddress的调用改为异步流程，先获取地址数据，再通过setState更新文本控制器。
4. 移除不必要的权限检查：如果仅加载已保存坐标，无需请求定位权限；若后续需要获取当前位置，再单独处理权限逻辑。

修正后的关键代码示例 #

变量初始化调整 #

GoogleMapController? _googleMapController;
late CameraPosition _cameraPosition;
late LatLng _latlong;

initState方法修改 #

@override
void initState() {
  super.initState();
  // 直接从widget读取已保存的坐标，初始化位置
  _latlong = LatLng(widget.editingAddress.latitude, widget.editingAddress.longitude);
  _cameraPosition = CameraPosition(target: _latlong, zoom: 15);
  
  // 初始化表单数据
  _personNameController.text = widget.editingAddress.personName;
  _addressLine1Controller.text = widget.editingAddress.addressLine1;
  _addressLine2Controller.text = widget.editingAddress.addressLine2;
  _landmarkController.text = widget.editingAddress.landmark ?? '';
  _cityController.text = widget.editingAddress.city;
  _stateController.text = widget.editingAddress.state;
  _pinCodeController.text = widget.editingAddress.pinCode;
  
  // 异步获取地址信息
  _fetchAddress();
}

新增异步获取地址的方法 #

Future<void> _fetchAddress() async {
  try {
    placeMarks = await placemarkFromCoordinates(_latlong.latitude, _latlong.longitude);
    Placemark placemark = placeMarks![0];
    setState(() {
      _addressLine1Controller.text = "${placemark.street ?? ''}, ${placemark.subThoroughfare ?? ''}";
      _addressLine2Controller.text = placemark.thoroughfare ?? '';
      _landmarkController.text = placemark.subThoroughfare ?? '';
      _cityController.text = placemark.subLocality ?? '';
      _stateController.text = placemark.administrativeArea ?? '';
      _pinCodeController.text = placemark.postalCode ?? '';
    });
  } catch (e) {
    print('获取地址失败: $e');
  }
}

GoogleMap组件调整 #

SizedBox(
  width: screenWidth,
  height: screenHeight * 0.225,
  child: GoogleMap(
    initialCameraPosition: _cameraPosition,
    onMapCreated: (controller) {
      _googleMapController = controller;
      // 可选：如果需要确保相机定位到目标位置，可在此处再次执行动画
      controller.animateCamera(CameraUpdate.newCameraPosition(_cameraPosition));
    },
    markers: {
      Marker(
        markerId: const MarkerId("1"),
        position: _latlong,
        icon: BitmapDescriptor.defaultMarkerWithHue(BitmapDescriptor.hueRed),
      ),
    },
    onCameraMove: (CameraPosition cameraposition) {
      _cameraPosition = cameraposition;
      _latlong = cameraposition.target;
      // 相机移动时异步更新地址
      _fetchAddress();
    },
  ),
)

移除冗余的getSavedLocation方法 #

因为已直接在initState中初始化坐标，且权限检查对加载保存坐标无意义，可删除原getSavedLocation方法。

额外注意事项 #

• 确保widget.editingAddress传递的经纬度值是有效的（非0值），可通过打印日志确认：print('保存的坐标: ${widget.editingAddress.latitude}, ${widget.editingAddress.longitude}')。
• 处理placemarkFromCoordinates可能抛出的异常（比如网络问题），避免崩溃。
• 使用late关键字声明_cameraPosition和_latlong，确保在initState中完成初始化，避免空安全问题。

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