Kotlin 中 lateinit 属性未初始化异常的成因与正确处理方案-java教程-PHP中文网

Kotlin 中 lateinit 属性未初始化异常的成因与正确处理方案

lateinit 变量必须在首次访问前完成初始化，而本例中 drawRouteOnMap() 在网络响应返回前就被调用，导致访问未初始化的 polyline，触发 UninitializedPropertyAccessException。

lateinit 变量必须在首次访问前完成初始化，而本例中 `drawrouteonmap()` 在网络响应返回前就被调用，导致访问未初始化的 `polyline`，触发 `uninitializedpropertyaccessexception`。

在 Kotlin Android 开发中，lateinit 是一种常见的延迟初始化机制，适用于无法在声明时赋值、但能确保在使用前完成初始化的非空引用类型变量（如 String、自定义对象等）。然而，它不提供运行时安全防护——一旦在初始化前被读取，便会立即抛出 UninitializedPropertyAccessException，且该异常不可捕获（属于 RuntimeException 子类），直接导致应用崩溃。

问题根源在于执行时序错配：

routesDetails() 发起异步网络请求（enqueue），其回调 onResponse 在主线程后续某个时刻执行；
但 onMapReady() 会在地图就绪后立即调用 drawRouteOnMap()，此时 polyline 尚未被赋值（网络请求远未完成）；
因此 PolyUtil.decode(polyline) 触发未初始化异常。

✅ 正确解法：将 drawRouteOnMap() 的调用严格置于 polyline 赋值之后，且仅在数据有效时执行：

private fun routesDetails(origin: String, destination: String, apiKey: String) {
    val routeService = ServiceBuilder.buildService(RouteService::class.java)
    val requestCall = routeService.getRoutes(origin, destination, apiKey)

    requestCall.enqueue(object : Callback<routesresponse> {
        override fun onResponse(
            call: Call<routesresponse>,
            response: Response<routesresponse>
        ) {
            if (response.isSuccessful && response.body()?.routes?.isNotEmpty() == true) {
                // ✅ 确保非空且有路线数据后再赋值
                polyline = response.body()!!.routes[0].overview_polyline.points.toString()

                // ✅ 唯一安全调用点：赋值完成后立即绘制
                drawRouteOnMap()
            } else {
                // ⚠️ 处理无路线/响应失败情况（如 Toast 提示、占位图）
                Toast.makeText(this@CustomerMapActivity, "No route found", Toast.LENGTH_SHORT).show()
            }
        }

        override fun onFailure(call: Call<routesresponse>, t: Throwable) {
            Log.e("RouteAPI", "Request failed", t)
            Toast.makeText(this@CustomerMapActivity, "Network error", Toast.LENGTH_SHORT).show()
        }
    })
}</routesresponse></routesresponse></routesresponse></routesresponse>

⚠️ 关键注意事项：

禁止在 onMapReady() 中直接调用 drawRouteOnMap() —— 此时 polyline 必然未初始化；
避免在 lateinit 变量上使用 ?. 安全调用 —— lateinit 不支持可空操作符，编译会报错；

推荐替代方案（更健壮）：若逻辑复杂或需多次访问，改用可空类型 var polyline: String? = null，配合 ?.let { } 或 requireNotNull() 显式校验：

private var polyline: String? = null
// ... 赋值同上
private fun drawRouteOnMap() {
    polyline?.let { points ->
        val decoded = PolyUtil.decode(points)
        // 绘制逻辑
    } ?: run {
        Log.w("Map", "Polyline not available yet")
    }
}