Android应用onMapReady函数未被调用，调用getMapAsync后地图标记无法添加

云原生阿岚

2026-9-28

Android Google Maps onMapReady未触发、标记无法添加排查方案

以下是针对代码已调用getMapAsync但回调仍未生效的具体排查步骤：

检查SupportMapFragment实例是否为空
你代码中使用了as?安全强转加?.安全调用，如果mapFragment为null，getMapAsync会直接跳过不执行。排查点：
1. 确认布局文件R.layout.fragment_dashboard中id为map的组件是正确配置的SupportMapFragment，正确布局示例：
```
<fragment
    android:id="@+id/map"
    android:name="com.google.android.gms.maps.SupportMapFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />
```
1. 如果当前代码写在Fragment类而非Activity类中，不能用supportFragmentManager查找子布局内的Fragment，需改用childFragmentManager，示例代码：
```
val mapFragment = childFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment
```
检查OnMapReadyCallback实现是否正确
1. 确认当前类声明处已显式实现com.google.android.gms.maps.OnMapReadyCallback接口，示例：
```
class YourActivity : AppCompatActivity(), OnMapReadyCallback
```
1. 排查导包是否错误，确认导入的Callback是Google Maps官方包下的，没有引入其他同名接口。
检查Google Maps配置有效性
1. 确认AndroidManifest.xml中已正确配置有效API Key：
```
<meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="你的Google Maps SDK for Android 有效API密钥" />
```
1. 检查build.gradle依赖是否正确引入Google Maps SDK，且版本与项目内其他Play服务依赖版本一致，避免依赖冲突。
日志辅助定位
在getMapAsync调用前添加日志打印mapFragment是否为null，在onMapReady方法首行添加日志，确认回调是否真的未触发，还是触发后标记添加逻辑有问题。