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)坐标的无效位置,也能从语法层面避免“访问未初始化变量”的硬崩溃。打通双异步回调的时序逻辑,避免地图、位置加载先后顺序导致的报错
地图加载、位置获取都是异步操作,谁先谁后没有固定顺序,必须两边都做兜底判断:- 把地图渲染的通用逻辑抽成独立方法,不管哪个分支拿到条件都能调用:
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) } } - 修改
onMapReady逻辑,不再直接访问currentLocation,统一走上面的渲染方法:override fun onMapReady(googleMap: GoogleMap) { mMap = googleMap renderCurrentLocationOnMap() } - 修改位置获取成功后的逻辑,拿到位置后也触发同一个渲染方法,删掉之前重复调用
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

