Fragment内Google地图map属性未初始化 调用getMapAsync仍无效

getMapAsync是异步加载方法，调用后不会立刻返回地图实例，只有当地图资源完全加载完成才会触发onMapReady回调。当前逻辑中如果configureMap的调用时机早于onMapReady触发，map属性自然还没完成初始化，判断条件不成立，折线绘制逻辑就不会执行。这个问题和把getMapAsync放在哪个生命周期方法调用没有关系，本质是异步回调时序和业务调用时序不匹配导致的。

• 增加待绘制参数缓存，兼容两种时序场景：地图先就绪、绘制逻辑后触发；绘制逻辑先调用、地图后加载完成。
  替换原有代码为如下实现：

class MyMapFragment : Fragment(), OnMapReadyCallback {
   private lateinit var map: GoogleMap
   // 缓存待执行的绘制参数
   private var pendingDrawStart: Pair<Double, Double>? = null
   private var pendingDrawEnd: Pair<Double, Double>? = null
  
   override fun onCreateView(
        inflater: LayoutInflater,
        container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View {
        // 保留原有视图绑定逻辑
        return inflater.inflate(R.layout.your_fragment_layout, container, false)
   }

   override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        val mapFragment = childFragmentManager.findFragmentById(R.id.r_map) as SupportMapFragment?
        mapFragment?.getMapAsync(this)
        // 保留其余初始化逻辑
    }
  
  override fun onMapReady(googleMap: GoogleMap) {
       map = googleMap
       // 地图加载完成后，如果存在待绘制的缓存参数，立刻执行绘制
       val start = pendingDrawStart
       val end = pendingDrawEnd
       if (start != null && end != null) {
           drawPolyLine(start.first, start.second, end.first, end.second)
           // 其余地图配置、绘制逻辑
           // 绘制完成清空缓存，避免重复触发
           pendingDrawStart = null
           pendingDrawEnd = null
       }
   }
  
  private fun configureMap(
        start: Pair<Double, Double>,
        end: Pair<Double, Double>,
   ) {
     if (this::map.isInitialized) {
         // 地图已初始化，直接执行绘制
         drawPolyLine(start.first, start.second, end.first, end.second)
         // 其余绘制逻辑
     } else {
         // 地图未就绪，缓存参数等待onMapReady触发后再绘制
         pendingDrawStart = start
         pendingDrawEnd = end
     }
  }

  private fun drawPolyLine(startLat: Double, startLng: Double, endLat: Double, endLng: Double) {
      // 保留原有折线绘制逻辑
  }
  // 保留其余方法逻辑
}

• 额外排查点：如果onMapReady始终不触发，检查childFragmentManager.findFragmentById(R.id.r_map)是否返回null。如果拿不到MapFragment实例，说明布局加载时序有问题，可以改成在onViewCreated里动态创建SupportMapFragment并添加到对应容器，避免静态写在布局里导致的Fragment查找失败。

注意：不要在主线程调用任何阻塞方法等待地图初始化，地图加载耗时受设备网络、Google Play服务版本影响，阻塞等待会触发ANR。

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