Flutter Google Map初始位置为空：Null check operator空值报错排查求助

错误原因 #

• 页面启动时，initState里调用的_setInitialLocation是异步方法，不会等待定位完成再执行build流程。第一次渲染UI时，_initialLocation还没被赋值，处于null状态，但代码里用_initialLocation!强制解包，直接触发空指针错误。
• 若用户拒绝定位权限、GPS未开启，getCurrentLocation会返回null，_initialLocation会一直保持null，后续操作也会触发相同错误。

修复方案 #

1. 设置默认初始坐标：给_initialLocation一个默认值（比如全球中心点），避免首次构建UI时出现null。
2. 添加加载状态：在定位结果返回前，显示加载组件，提升用户等待体验。
3. 处理定位失败场景：当定位失败时，提示用户检查权限或GPS服务状态。

修改后的完整代码 #

import 'package:flutter/material.dart';
import 'package:google_maps_flutter/google_maps_flutter.dart';
import 'package:location/location.dart';

class FindSomeonePage extends StatefulWidget {
  const FindSomeonePage({Key? key}) : super(key: key);

  @override
  State<FindSomeonePage> createState() => _FindSomeonePageState();
}

class _FindSomeonePageState extends State<FindSomeonePage> {
  // 给初始位置设置默认值（全球中心点）
  LatLng? _initialLocation = const LatLng(0, 0);
  late GoogleMapController mapController;
  // 标记定位是否进行中
  bool _isLocating = true;
  // 定位失败提示文本
  String? _errorMessage;

  @override
  void initState() {
    super.initState();
    _setInitialLocation();
  }

  _setInitialLocation() async {
    setState(() {
      _isLocating = true;
      _errorMessage = null;
    });

    LocationData? currentLocation = await getCurrentLocation();
    if (currentLocation != null) {
      setState(() {
        _initialLocation = LatLng(
          currentLocation.latitude!,
          currentLocation.longitude!
        );
        // 定位成功后，将地图镜头移动到当前位置
        mapController.animateCamera(
          CameraUpdate.newCameraPosition(
            CameraPosition(target: _initialLocation!, zoom: 15.0)
          )
        );
      });
    } else {
      setState(() {
        _errorMessage = "定位失败，请检查GPS权限和服务状态";
      });
    }

    setState(() {
      _isLocating = false;
    });
  }

  @override
  Widget build(BuildContext context) {
    return SafeArea(
      child: Scaffold(
        body: Stack(
          children: [
            GoogleMap(
              initialCameraPosition: CameraPosition(
                target: _initialLocation!,
                zoom: 15.0,
              ),
              onMapCreated: (controller) {
                mapController = controller;
              },
            ),
            // 定位过程中显示半透明加载遮罩
            if (_isLocating)
              Container(
                color: Colors.black54,
                child: const Center(child: CircularProgressIndicator(color: Colors.white)),
              ),
            // 定位失败时显示提示条
            if (_errorMessage != null)
              Positioned(
                top: 20,
                left: 20,
                right: 20,
                child: Container(
                  padding: const EdgeInsets.all(12),
                  color: Colors.redAccent,
                  child: Text(_errorMessage!, style: const TextStyle(color: Colors.white)),
                ),
              ),
          ],
        ),
      ),
    );
  }
}

Future<LocationData?> getCurrentLocation() async {
  Location location = Location();

  bool _serviceEnabled;
  PermissionStatus _permissionGranted;

  _serviceEnabled = await location.serviceEnabled();
  if (!_serviceEnabled) {
    _serviceEnabled = await location.requestService();
    if (!_serviceEnabled) {
      return null;
    }
  }

  _permissionGranted = await location.hasPermission();
  if (_permissionGranted == PermissionStatus.denied) {
    _permissionGranted = await location.requestPermission();
    if (_permissionGranted != PermissionStatus.granted) {
      return null;
    }
  }

  return await location.getLocation();
}

关键修改点说明 #

• 给_initialLocation设置默认值，避免首次构建UI时的空指针错误。
• 增加_isLocating状态，定位过程中显示加载动画，让用户感知等待状态。
• 添加_errorMessage，定位失败时展示明确的提示信息。
• 定位成功后通过mapController.animateCamera动态移动地图到当前位置，不再依赖初始默认坐标。

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