Flutter项目无法获取Android位置权限：initLocation方法未执行

核心问题 #

1. 方法参数缺失：你的initLocation方法定义需要接收GoogleMapController参数，但在onViewModelReady中调用时没有传参，这会直接导致方法无法正常执行，甚至触发编译错误。
2. 执行时机错误：onViewModelReady会在ViewModel初始化完成后立即执行，但此时GoogleMapController还未被初始化（它要等到GoogleMap组件创建完成，通过onMapCreated回调才能获取），就算强行传参也会是null，后续地图定位逻辑无法运行。

修复步骤 #

1. 调整initLocation的调用时机

将initLocation的调用从onViewModelReady移到onMapCreated回调中，确保获取到有效的GoogleMapController后再执行定位逻辑：

修改视图层代码：

class GoogleMapState extends State<GoogleMapWidget> {
  late GoogleMapController mapController;
  final LatLng _center = const LatLng(45.521563, -122.677433);
  // 保存ViewModel实例，方便在onMapCreated中调用
  late GoogleMapViewModel _viewModel;

  void onMapCreated(GoogleMapController controller) {
    mapController = controller;
    // 地图创建完成后，调用ViewModel的initLocation并传入controller
    _viewModel.initLocation(mapController);
  }

  @override
  Widget build(BuildContext context) {
    return ViewModelBuilder<GoogleMapViewModel>.reactive(
      viewModelBuilder: () => GoogleMapViewModel(),
      onViewModelReady: (viewModel) {
        // 保存ViewModel实例
        _viewModel = viewModel;
      },
      builder: (context, viewModel, child) {
        return MaterialApp(
          home: Scaffold(
            body: Stack(
              children: [
                GoogleMap(
                  onMapCreated: onMapCreated,
                  initialCameraPosition: CameraPosition(
                    target: _center,
                    zoom: 11.0,
                  ),
                ),
                Positioned(
                  bottom: 16.0,
                  left: 16.0,
                  child: FloatingActionButton(
                    onPressed: viewModel.locationEnabled
                        ? () => viewModel.recenterMap(mapController)
                        : null,
                    child: Icon(
                      !viewModel.locationEnabled
                          ? Icons.gps_off_outlined
                          : (viewModel.isCentered
                              ? Icons.gps_fixed_outlined
                              : Icons.gps_not_fixed_outlined),
                    ),
                  ),
                ),
              ],
            ),
          ),
        );
      },
    );
  }
}

2. 补充权限配置（关键前提）

确保你已经在平台配置文件中添加了定位权限：

• Android：在android/app/src/main/AndroidManifest.xml中添加：

<!-- 粗略定位权限 -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- 精确定位权限 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!-- Android 12+ 后台定位权限（如果需要） -->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

• iOS：在ios/Runner/Info.plist中添加：

<key>NSLocationWhenInUseUsageDescription</key>
<string>需要获取您的位置信息以展示地图定位</string>
<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>需要获取您的位置信息以展示地图定位</string>

3. 优化ViewModel中的异常处理

在initLocation的catch块中添加日志打印，方便排查定位失败的具体原因：

Future<void> initLocation(GoogleMapController mapController) async {
    setBusy(true);
    final hasPermission = await _handlePermission();

    if (!hasPermission) {
      _locationEnabled = false;
      notifyListeners();
      setBusy(false);
      return;
    }

    try {
      final position = await Geolocator.getCurrentPosition(desiredAccuracy: LocationAccuracy.high);

      _currentPosition = LatLng(position.latitude, position.longitude);
      _isCentered = true;

      await mapController.animateCamera(
        CameraUpdate.newLatLngZoom(_currentPosition!, 15.5),
      );
    } catch (e) {
      // 添加日志打印
      print('定位失败原因：$e');
      _currentPosition = defaultLatLng;
      _isCentered = true;

      await mapController.animateCamera(
        CameraUpdate.newLatLngZoom(defaultLatLng, 15.5),
      );
    }
    // 确保最后都通知监听者并取消忙碌状态
    _locationEnabled = true;
    notifyListeners();
    setBusy(false);
  }

额外检查点 #

• 确认geolocator包的版本与Flutter SDK版本兼容，避免版本冲突。
• 测试时确保设备的定位服务已开启，并且应用已被授予定位权限。

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