Android Google Maps：onMapReady未调用？调用getMapAsync后mGoogleMap未初始化

你遇到的这个NullPointerException是Google Maps开发里的高频坑——核心原因就是getMapAsync()是异步执行的，调用它之后并不会立刻生成可用的GoogleMap实例，必须等onMapReady()回调触发后，mGoogleMap才会被正确初始化。如果在回调触发前就调用addMarker()这类依赖mGoogleMap的方法，自然就会触发空指针异常。

给你几个针对性的解决方案，结合你的代码场景来调整：

1. 把所有地图操作逻辑移到onMapReady()里 #

这是最稳妥的做法，确保所有依赖mGoogleMap的代码都在回调中执行，从根源避免空指针：

@Override
public void onMapReady(GoogleMap googleMap) {
    // 先完成mGoogleMap的初始化赋值
    mGoogleMap = googleMap;
    
    // 在这里执行addMarker、设置地图属性等操作
    LatLng startGps = new LatLng(Double.parseDouble(GPSstart.split(",")[0]), 
                                 Double.parseDouble(GPSstart.split(",")[1]));
    mGoogleMap.addMarker(new MarkerOptions().position(startGps).title("骑行起点"));
    // 还可以顺便设置地图缩放、定位权限等
    mGoogleMap.setMyLocationEnabled(true);
    mGoogleMap.moveCamera(CameraUpdateFactory.newLatLngZoom(startGps, 16));
}

2. 非回调场景下调用地图方法前做空检查 #

如果你的业务逻辑没办法全部放在onMapReady()里（比如需要在LocationListener的回调中动态添加标记），那每次调用mGoogleMap的方法前都要先判断它是否不为null：

@Override
public void onLocationChanged(Location location) {
    // 先检查mGoogleMap是否已初始化
    if (mGoogleMap != null) {
        LatLng currentLoc = new LatLng(location.getLatitude(), location.getLongitude());
        mGoogleMap.addMarker(new MarkerOptions().position(currentLoc).title("当前位置"));
    }
}

3. 确认getMapAsync()的调用时机 #

要确保getMapAsync()是在Activity生命周期的合适阶段调用，比如在onCreate()或者onResume()中，不要在构造函数、onDestroy()这类不合适的阶段调用：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_ride_start);
    
    // 初始化地图Fragment并调用异步方法
    SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager()
            .findFragmentById(R.id.map);
    if (mapFragment != null) {
        mapFragment.getMapAsync(this);
    }
    
    // 其他初始化逻辑...
}

额外提醒：千万别用已废弃的同步获取方法（比如mapFragment.getMap()）手动给mGoogleMap赋值，这种方式不仅不安全，还会导致更多不可控的空指针问题，必须坚持用getMapAsync() + onMapReady()的异步初始化流程。

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