Kotlin从当前位置获取地址时遇超时异常求助

一、获取地址的核心思路 #

要把经纬度转换成实际地址，Android的Geocoder类是核心工具，它能通过正向地理编码把经纬度映射为结构化地址信息。你的实现方向是对的，但需要注意版本兼容和线程处理细节：

关键注意事项： #

• Android 33（API 33）及以上提供了异步的getFromLocation方法，无需手动处理线程；
• 33以下的getFromLocation是同步方法，绝对不能在主线程调用，否则会阻塞UI，甚至触发超时或ANR；
• Geocoder依赖系统地理编码服务，部分设备可能存在服务不可用的情况，必须做好异常兜底。

二、解决「超时：已超过4.907678698秒的截止期限」异常 #

你遇到的异常翻译为：java.io.IOException: eccc: 超时：已超过4.907678698秒的截止期限

这个问题通常由以下原因导致，对应解决方案如下：

1. 同步方法在主线程执行 #

33以下的getFromLocation是同步IO操作，主线程有严格的超时限制，直接调用必然触发超时。必须将其放到后台线程执行，比如用Kotlin协程：

// 33以下版本的同步方法需放到后台线程
lifecycleScope.launch(Dispatchers.IO) {
    try {
        val addresses = geocoder.getFromLocation(location.latitude, location.longitude, 1)?.firstOrNull()
        // 回到主线程更新UI
        withContext(Dispatchers.Main) {
            address.value = addresses?.getAddressLine(0) ?: "未找到地址"
        }
    } catch (e: Exception) {
        withContext(Dispatchers.Main) {
            address.value = "地址查询失败"
        }
        e.printStackTrace()
    }
}

2. 缺少必要权限 #

Geocoder部分场景需要网络支持，确保你的AndroidManifest.xml中添加了以下权限：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

3. 未指定Locale #

如果设备默认Locale不支持当前地区的地理编码，可能导致查询超时或失败。建议手动指定Locale：

val geocoder = Geocoder(app, Locale.getDefault()) // 或指定具体Locale如Locale.CHINA

4. 异步方法未处理空结果 #

33及以上的异步回调中，需先判断addresses是否为空，避免空指针：

if (Build.VERSION.SDK_INT >= 33) {
    geocoder.getFromLocation(location.latitude, location.longitude, 1) { addresses ->
        address.value = addresses.firstOrNull()?.getAddressLine(0) ?: "未找到地址"
    }
}

修正后的完整代码示例 #

val fusedLocationClient: FusedLocationProviderClient =
    LocationServices.getFusedLocationProviderClient(LocalContext.current)

fun getLastKnownLocation() {
    fusedLocationClient.lastLocation.addOnSuccessListener { location ->
        if (location != null) {
            longitude.value = location.longitude
            latitude.value = location.latitude

            val geocoder = Geocoder(app, Locale.getDefault())
            if (Build.VERSION.SDK_INT >= 33) {
                geocoder.getFromLocation(location.latitude, location.longitude, 1) { addresses ->
                    address.value = addresses.firstOrNull()?.getAddressLine(0) ?: "未找到地址"
                }
            } else {
                // 33以下版本用协程放到后台线程
                lifecycleScope.launch(Dispatchers.IO) {
                    val addresses = try {
                        geocoder.getFromLocation(location.latitude, location.longitude, 1)?.firstOrNull()
                    } catch (e: Exception) {
                        e.printStackTrace()
                        null
                    }
                    withContext(Dispatchers.Main) {
                        address.value = addresses?.getAddressLine(0) ?: "地址查询失败"
                    }
                }
            }
        }
    }
}

注意：使用lifecycleScope需要依赖AndroidX Lifecycle库，确保你的build.gradle中添加了相关依赖。

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