You need to enable JavaScript to run this app. Kotlin开发中GoogleMap无法显示当前位置及currentLocation赋值失效问题
优惠活动
大模型
产品
解决方案
定价
更多

Kotlin开发中GoogleMap无法显示当前位置及currentLocation赋值失效问题

核心报错原因定位
  • 变量修饰符与时序不匹配:给currentLocation加lateinit修饰,意味着系统要求这个变量必须在第一次被访问前完成初始化,但在onCreate一开始就绑定了地图的异步回调,onMapReady的触发根本不等位置数据返回就会执行,直接访问未初始化的currentLocation,抛出未初始化异常。
  • 缓存位置接口的固有局限性:fusedLocationProviderClient.lastLocation返回值为null是常态——如果设备近期没有其他应用触发过位置上报,这个缓存值就会为空,当前代码在location为null的分支没有任何兜底逻辑,导致currentLocation永远无法完成赋值。
  • 权限判断逻辑写反:在权限检查时用&&连接两个位置权限的判断,实际应该用||,只要任意一个位置权限授予,就不应该重复触发权限申请弹窗。
  • 重复绑定地图回调:在位置成功获取的分支里又调用了一次getMapAsync,会导致onMapReady被重复触发,反而打乱渲染逻辑。
分步修复方案
  • 调整变量声明方式,从根源避免未初始化崩溃
    把原来的lateinit var currentLocation : Location改成可空普通变量:
    private var currentLocation: Location? = null
    完全替代之前想用Location("")造占位对象的写法,既不需要额外造(0,0)坐标的无效位置,也能从语法层面避免“访问未初始化变量”的硬崩溃。

  • 打通双异步回调的时序逻辑,避免地图、位置加载先后顺序导致的报错
    地图加载、位置获取都是异步操作,谁先谁后没有固定顺序,必须两边都做兜底判断:

    1. 把地图渲染的通用逻辑抽成独立方法,不管哪个分支拿到条件都能调用:
      private fun renderCurrentLocationOnMap() {
          // 两个条件缺一不可:地图加载完成、位置拿到
          if (::mMap.isInitialized && currentLocation != null) {
              val latLng = LatLng(currentLocation!!.latitude, currentLocation!!.longitude)
              val markerOptions = MarkerOptions().position(latLng).title("I am here")
              // 原来的5倍缩放太模糊,调整到15倍,刚好是街道级别的默认视角
              mMap.animateCamera(CameraUpdateFactory.newLatLngZoom(latLng, 15f))
              mMap.addMarker(markerOptions)
          }
      }
      
    2. 修改onMapReady逻辑,不再直接访问currentLocation,统一走上面的渲染方法:
      override fun onMapReady(googleMap: GoogleMap) {
          mMap = googleMap
          renderCurrentLocationOnMap()
      }
      
    3. 修改位置获取成功后的逻辑,拿到位置后也触发同一个渲染方法,删掉之前重复调用getMapAsync的冗余代码:
      task.addOnSuccessListener { location ->
          if (location != null) {
              currentLocation = location
              Toast.makeText(applicationContext, "Lati: ${location.latitude}  Long: ${location.longitude}", Toast.LENGTH_SHORT).show()
              renderCurrentLocationOnMap()
          }
      }
      

    这样不管是地图先加载完、还是位置先拿到,只要两个条件凑齐,就会自动渲染当前位置,不会因为时序问题崩溃。

  • 给lastLocation返回null的场景加兜底
    当lastLocation取不到缓存值的时候,主动请求一次新的实时位置,避免位置永远拿不到——在原来的onSuccess的location == null分支,加上主动触发位置更新的逻辑,不用做长期监听,拿到一次有效位置就停止即可。

  • 修正权限检查的逻辑错误
    把原来的权限判断条件从:
    if (checkSelfPermission(ACCESS_FINE) != GRANTED && checkSelfPermission(ACCESS_COARSE) != GRANTED)
    改成:
    if (checkSelfPermission(ACCESS_FINE) != GRANTED || checkSelfPermission(ACCESS_COARSE) != GRANTED)
    避免因为逻辑判断写反,明明已经有权限还重复申请的问题。

补充注意点
  • 不要在onSuccess返回null的时候什么都不做,这是缓存位置接口的正常行为,不是代码异常。
  • 不要依赖固定的加载顺序写异步逻辑,只要两个异步操作的回调里都调用统一的兜底判断方法,就不会出现初始化时序问题。

内容的提问来源于stack exchange,提问作者fariji1294

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.08 18:36:04