在onMapReady中调用getMapCapabilities为何触发NullPointerException？

问题根源 #

你遇到的NullPointerException并非GoogleMap实例为空导致，而是Google Maps SDK内部在初始化MapCapabilities对象时，因底层地图服务未提供有效能力数据触发了checkNotNull校验失败。虚拟设备（尤其是配置不当的模拟器）是高发场景：getMapCapabilities()依赖Google Play服务的地图组件返回能力信息，若模拟器的Google Play服务版本不兼容、未完整安装或地图组件加载不充分，SDK内部就会返回空值触发报错。

可行解决方案 #

• 使用官方Google Play模拟器镜像：创建AVD时选择带「Google Play」标识的系统镜像（而非仅「Google APIs」），这类镜像预装了完整且兼容的Google Play服务套件。启动后打开Play商店，确保Google Play服务为最新版本。
• 延迟调用getMapCapabilities()：onMapReady()回调仅表示GoogleMap实例初始化完成，但底层地图资源可能未完全加载。通过setOnMapLoadedCallback()等待地图加载完成后再调用：

@Override
public void onMapReady(@NonNull GoogleMap googleMap) {
    googleMap.setOnMapLoadedCallback(() -> {
        MapCapabilities mapCapabilities = googleMap.getMapCapabilities();
        // 执行AdvancedMarkers支持性检查逻辑
    });
}

• 调整Maps SDK版本：当前使用的play-services-maps:18.2.0可能存在兼容性问题，尝试切换至稳定版本（如18.1.0或最新稳定版），注意保持play-services-basement版本与Maps SDK版本一致。
• 优化模拟器硬件配置：确保模拟器启用硬件加速（AVD设置→显示→图形选择「Hardware - GLES 2.0+」），并使用Android 10及以上的系统镜像，提升地图组件加载稳定性。

替代检查方案 #

若上述方法仍无法解决，可直接通过实例化AdvancedMarkerOptions来验证支持性，避免依赖MapCapabilities：

try {
    new AdvancedMarkerOptions();
    // 执行支持AdvancedMarkers的逻辑
} catch (UnsupportedOperationException e) {
    // 设备不支持AdvancedMarkers
}

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