本文详解 android 应用因过早请求位置权限或未正确处理权限回调而引发的首次启动崩溃问题，提供符合 android 权限最佳实践的完整解决方案，涵盖运行时权限检查、异步定位流程控制及生命周期安全调用。
本文详解 android 应用因过早请求位置权限或未正确处理权限回调而引发的首次启动崩溃问题，提供符合 android 权限最佳实践的完整解决方案，涵盖运行时权限检查、异步定位流程控制及生命周期安全调用。
在 Android 6.0（API 23）及以上版本中，ACCESS_FINE_LOCATION 和 ACCESS_COARSE_LOCATION 属于危险权限，必须在运行时动态申请。许多开发者在 Activity 的 onCreate() 或 onStart() 中立即检查并请求权限，同时同步调用定位逻辑（如 FusedLocationProviderClient.getLastLocation()）——这正是导致“首次点击‘允许’后闪退”的根本原因：系统尚未完成权限授予回调，定位 API 却已尝试访问受保护资源，抛出 SecurityException 或空指针异常。
✅ 正确做法：权限与定位解耦 + 生命周期感知
核心原则是：先确保权限就绪，再执行定位；且所有定位操作必须在权限确认通过后的回调中触发。 以下是推荐实现（基于 AndroidX 和 ActivityCompat / ActivityResultLauncher）：
✅ 推荐方案：使用 Activity Result API（AndroidX 推荐方式）
// 在 Activity/Fragment 中声明
private val locationPermissionLauncher = registerForActivityResult(
ActivityResultContracts.RequestPermission()
) { isGranted ->
if (isGranted) {
// ✅ 权限已授予，安全执行定位逻辑
fetchCurrentLocation()
} else {
// ⚠️ 用户拒绝或勾选“不再询问”，应引导用户手动开启
Toast.makeText(this, "定位权限被拒绝，部分功能不可用", Toast.LENGTH_SHORT).show()
}
}
private fun requestLocationPermission() {
// 检查是否已拥有权限
if (ContextCompat.checkSelfPermission(
this,
Manifest.permission.ACCESS_FINE_LOCATION
) != PackageManager.PERMISSION_GRANTED
) {
// 触发权限请求（不阻塞主线程）
locationPermissionLauncher.launch(Manifest.permission.ACCESS_FINE_LOCATION)
} else {
// 权限已存在，直接定位
fetchCurrentLocation()
}
}
private fun fetchCurrentLocation() {
val client = LocationServices.getFusedLocationProviderClient(this)
client.lastLocation
.addOnSuccessListener { location ->
if (location != null) {
Log.d("Location", "Lat: ${location.latitude}, Lng: ${location.longitude}")
// 更新 UI 或业务逻辑
}
}
.addOnFailureListener { e ->
Log.e("Location", "获取位置失败", e)
}
}
⚠️ 关键注意事项
- 禁止在 onCreate() 中同步调用定位 API：即使权限已授予，FusedLocationProviderClient 初始化可能未完成，建议延迟至 onStart() 后或使用 addOnCompleteListener 确保客户端就绪。
- 处理“拒绝且不再询问”场景：可调用 shouldShowRequestPermissionRationale() 判断是否需展示解释性说明，提升用户体验。
- 适配 Android 12+（API 31）：需额外申请 ACTIVITY_RECOGNITION（若涉及运动状态），且后台定位需声明 ACCESS_BACKGROUND_LOCATION 并单独申请。
- 模拟器调试提示：Android 模拟器默认无 GPS，需通过 Extended Controls → Location 手动设置坐标，并确保 Google Play Services 已更新。
✅ 总结
该崩溃本质是权限状态与业务逻辑的竞态条件（race condition）。解决关键在于：
① 使用 ActivityResultLauncher 替代过时的 requestPermissions() + onRequestPermissionsResult()；
② 将定位调用严格约束在权限回调成功分支内；
③ 始终检查 location 是否为 null（尤其在模拟器或无 GPS 设备上）；
④ 在 AndroidManifest.xml 中正确声明权限（含 android:name 和 android:usesPermissionFlags 属性）。
遵循以上模式，即可彻底规避首次授权后崩溃问题，并构建健壮、合规的位置功能模块。
