本文详解 Android 应用因过早请求位置数据引发的首次运行崩溃问题，重点讲解如何在获取 ACCESS_FINE_LOCATION 权限后，正确等待权限回调完成再执行定位逻辑，避免空指针或权限状态不一致导致的 Crash。
本文详解 android 应用因过早请求位置数据引发的首次运行崩溃问题，重点讲解如何在获取 `access_fine_location` 权限后，**正确等待权限回调完成再执行定位逻辑**，避免空指针或权限状态不一致导致的 crash。
在 Android 6.0（API 23）及以上版本中，危险权限（如定位、存储、相机等）必须在运行时动态申请。许多开发者在 onCreate() 或 onStart() 中直接调用定位 API（如 FusedLocationProviderClient.getLastLocation()），同时又未妥善处理权限流程，导致“用户刚点‘允许’，应用就崩溃”的典型现象——并非权限未授予，而是代码在 onRequestPermissionsResult() 回调尚未执行、权限状态未同步更新时，已贸然访问定位服务。
根本原因在于：
- ActivityCompat.requestPermissions() 是异步操作；
- 用户点击“允许”后，系统需时间更新 PackageManager 内部状态；
- 若在 onRequestPermissionsResult() 外提前调用 checkSelfPermission() 并紧接着执行定位，极可能因状态未刷新而误判为“已授权”，实则 LocationManager 或 FusedLocationProviderClient 仍被拒绝访问，抛出 SecurityException 或返回 null 引发 NPE。
✅ 正确实践：所有定位操作必须严格置于权限确认之后。推荐采用以下结构：
private fun requestLocationPermission() {
if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION)
!= PackageManager.PERMISSION_GRANTED) {
ActivityCompat.requestPermissions(
this,
arrayOf(Manifest.permission.ACCESS_FINE_LOCATION),
LOCATION_PERMISSION_REQUEST_CODE
)
} else {
// 权限已授予 → 安全执行定位
getLocation()
}
}
override fun onRequestPermissionsResult(
requestCode: Int,
permissions: Array<out String>,
grantResults: IntArray
) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults)
if (requestCode == LOCATION_PERMISSION_REQUEST_CODE) {
if (grantResults.isNotEmpty() && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
// ✅ 权限已获批准 → 立即执行定位
getLocation()
} else {
// ❌ 拒绝权限，提示用户或降级功能
Toast.makeText(this, "定位功能需要位置权限", Toast.LENGTH_SHORT).show()
}
}
}
private fun getLocation() {
// 此处可安全调用 FusedLocationProviderClient 或 LocationManager
fusedLocationClient.lastLocation
.addOnSuccessListener { location ->
if (location != null) {
Log.d("Location", "Lat: ${location.latitude}, Lng: ${location.longitude}")
}
}
.addOnFailureListener { e ->
Log.e("Location", "获取位置失败", e)
}
}⚠️ 关键注意事项：
- 禁止在 requestPermissions() 后立即调用定位逻辑（常见错误）；
- onRequestPermissionsResult() 是唯一可靠的权限状态确认入口，所有敏感操作必须在此回调内触发；
- 建议使用 ActivityResultLauncher（AndroidX Activity 1.2.0+）替代过时的 onRequestPermissionsResult()，实现更简洁、生命周期安全的权限请求：
private val locationPermissionLauncher = registerForActivityResult(
ActivityResultContracts.RequestPermission()
) { isGranted ->
if (isGranted) {
getLocation() // 安全执行
} else {
showPermissionRationale()
}
}
// 调用时
locationPermissionLauncher.launch(Manifest.permission.ACCESS_FINE_LOCATION)总结：定位崩溃的本质是权限检查与实际使用之间的竞态条件。遵循“检查→申请→回调确认→执行”的四步闭环，结合现代 API（如 ActivityResultLauncher），即可彻底规避首次崩溃，提升应用稳定性与用户体验。
