Flutter中Google Map定位图层无法显示的问题排查

我之前在项目里也踩过一模一样的坑！你已经做了权限声明和开启myLocationEnabled，但还是看不到定位图标和按钮，大概率是这几个容易漏掉的环节出了问题——不需要额外依赖，咱们一步步排查：

1. 必须主动请求权限（光声明没用！） #

你在AndroidManifest.xml和Info.plist里加了权限声明，但系统不会自动给你授权，得在代码里主动请求用户同意。推荐用permission_handler包来处理跨平台权限：

首先在pubspec.yaml里加依赖：

permission_handler: ^10.2.0

然后在初始化地图前请求定位权限：

import 'package:permission_handler/permission_handler.dart';

// 在初始化地图的逻辑里先请求权限
Future<void> _requestLocationPermission() async {
  var status = await Permission.locationWhenInUse.request();
  if (status.isGranted) {
    // 权限通过，初始化地图
    setState(() {
      _locationPermissionGranted = true;
    });
  } else {
    // 处理权限拒绝的情况，比如弹提示引导用户去设置里开启
  }
}

只有当权限被用户授予后，地图的定位功能才会真正生效。

2. 检查Google Maps API密钥的配置和权限 #

你有没有在AndroidManifest.xml和iOS的配置里添加Google Maps的API密钥？这是最容易忘的关键步骤：

• Android：在AndroidManifest.xml的<application>标签里添加：

<meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="你的Google Maps API密钥"/>

• iOS：在AppDelegate.swift中设置API密钥，同时确保你的API密钥已经在Google Cloud控制台启用了Maps SDK for Android和Maps SDK for iOS服务。

3. 升级google_maps_flutter的版本 #

你用的^0.5.13是非常老旧的版本（当前稳定版已经到2.x系列），旧版本对myLocationEnabled的支持存在已知bug。建议升级到最新稳定版：

google_maps_flutter: ^2.5.0

升级后记得执行flutter pub get，然后清理项目缓存并重启。

4. 动态启用定位（可选） #

如果权限是在地图初始化之后才获取的，你可以通过GoogleMapController动态开启定位：

void _onMapCreated(GoogleMapController controller) {
  _mapController = controller;
  // 权限通过后再启用定位
  if (_locationPermissionGranted) {
    _mapController.setMyLocationEnabled(true);
  }
}

最后补个小细节 #

Android端除了ACCESS_FINE_LOCATION，可以再加一个ACCESS_COARSE_LOCATION权限，提升兼容性：

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>

按照上面的步骤排查下来，应该就能正常显示定位图标和按钮了！

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