Android平台Google Maps动态添加Marker遇空指针异常求助

嗨，我来帮你搞定这个空指针错误！你遇到的java.lang.NullPointerException: Attempt to invoke virtual method 'com.google.android.gms.maps.model.Marker com.google.android.gms.maps.GoogleMap.addMarker(...)' on a null object reference，本质原因很简单：你调用addMarker()方法的时候，GoogleMap的实例还没初始化完成，处于null状态。

在Fragment的onCreateView阶段，地图控件还在异步加载中，这时候直接获取GoogleMap对象肯定拿不到有效的实例，自然就会抛出空指针。下面是具体的解决步骤：

步骤1：确保布局里的地图控件正确配置 #

先检查你的Fragment布局文件，确保正确引入了SupportMapFragment：

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

步骤2：用异步回调等待地图初始化完成 #

不要在onCreateView里直接操作地图，而是通过getMapAsync()监听地图加载完成的回调，修改你的Fragment代码：

首先，给Fragment添加GoogleMap成员变量，并让Fragment实现OnMapReadyCallback接口：

public class YourMapFragment extends Fragment implements OnMapReadyCallback {
    private View mView;
    private GoogleMap mMap; // 地图实例变量

    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
        mView = inflater.inflate(R.layout.your_fragment_layout, container, false);
        
        // 获取布局里的SupportMapFragment
        SupportMapFragment mapFragment = (SupportMapFragment) getChildFragmentManager()
                .findFragmentById(R.id.map_fragment);
        // 设置异步回调，等地图加载好再执行操作
        mapFragment.getMapAsync(this);
        
        return mView;
    }

    // 地图初始化完成后会触发这个方法
    @Override
    public void onMapReady(GoogleMap googleMap) {
        mMap = googleMap;
        
        // 现在可以安全地添加Marker了！
        MarkerOptions markerOptions = new MarkerOptions()
                .position(new LatLng(37.7749, -122.4194)) // 替换成你的目标坐标
                .title("我的Marker");
        mMap.addMarker(markerOptions);
        
        // 可选：让地图镜头移动到Marker位置
        mMap.moveCamera(CameraUpdateFactory.newLatLngZoom(new LatLng(37.7749, -122.4194), 12));
    }
}

避坑提醒 #

• 别再用已经废弃的getMap()方法，必须用getMapAsync()来异步获取地图实例
• 确保布局里的Fragment ID和代码中findFragmentById()的ID完全一致
• 检查设备上是否安装了Google Play Services，如果没有，地图无法正常初始化，onMapReady也不会被触发

内容的提问来源于stack exchange，提问作者Edo A.