getMapAsync未触发onMapReady回调，GoogleMap对象无法初始化

看起来你遇到的核心问题是getMapAsync()的回调完全没执行，连日志都打不出来——这和单纯的空指针问题不一样，得从地图初始化的前置配置和代码细节入手排查，我给你列几个最常见的原因和解决办法：

1. 先检查Google Maps API密钥的配置是否完全正确 #

这是最容易踩坑的点，很多时候回调不触发就是因为API密钥没配置对：

• 确保你的AndroidManifest.xml里已经正确添加了API密钥的meta-data标签：

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

• 去Google Cloud控制台确认：
  • 这个密钥所在的项目已经启用了Maps SDK for Android服务；
  • 密钥绑定的SHA-1指纹包含了你当前测试用的debug（或release）签名的指纹；
  • 密钥没有被限制到错误的包名。

2. 确认MapFragment的类型和初始化方式正确 #

如果你用的是AndroidX项目（现在大部分新项目都是），一定要用SupportMapFragment而不是旧的MapFragment，否则会出现初始化失败的情况：

• 布局文件里的Fragment标签要指定正确的类：

  <fragment
      android:id="@+id/maps_fragment"
      android:name="com.google.android.gms.maps.SupportMapFragment"
      android:layout_width="match_parent"
      android:layout_height="match_parent"/>
  

• 代码里初始化的时候也要用getSupportFragmentManager()：

  SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.maps_fragment);
  mapFragment.getMapAsync(new OnMapReadyCallback() {
      @Override
      public void onMapReady(GoogleMap gMap) {
          Log.d(MAPSACTIVITY_TAG,"Maps is ready");
          googleMap=gMap;
          // 所有地图操作都移到这里
      }
  });
  

3. 检查依赖和设备环境 #

• 确保app的build.gradle里添加了正确的Maps依赖（建议用最新稳定版）：

  implementation 'com.google.android.gms:play-services-maps:18.1.0'
  

• 检查测试设备上的Google Play服务是否正常：如果设备的Google Play服务版本过低或者未安装，地图根本无法初始化。可以在设备的「设置-应用管理-Google Play服务」里查看版本，或者尝试更新。
• 别忘了在AndroidManifest里添加基础权限：

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

  地图加载需要网络权限，没有的话也会导致初始化失败。

4. 调整代码逻辑：所有地图操作必须放在回调内 #

另外，你当前代码里有个逻辑错误：在调用getMapAsync()之后立刻打印googleMap、调用setMyLocationEnabled——这时候回调还没执行，googleMap肯定是空的。哪怕回调正常触发，这部分代码也会先执行。正确的做法是把所有需要操作GoogleMap的代码全部移到onMapReady()回调里面，比如：

@Override
public void onMapReady(GoogleMap gMap) {
    Log.d(MAPSACTIVITY_TAG,"Maps is ready");
    googleMap=gMap;

    // 在这里处理地图初始化后的所有操作
    if (isLocationPermissionGranted) {
        if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED && ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
            Toast.makeText(context, "Sorry! App requires location permission", Toast.LENGTH_SHORT).show();
            return;
        }
        googleMap.setMyLocationEnabled(true);
        getDeviceLocation();
        buildGoogleApiClient();
        geoLocateClient();
    } else {
        Log.d(MAPSACTIVITY_TAG, "Location permission is not given");
    }
}

按照上面的步骤逐一排查，应该能解决回调不触发的问题。

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