本文详解 android 应用因未正确处理运行时定位权限（如 access_fine_location）而引发的首次启动闪退问题，提供安全、合规的权限请求与位置获取流程，并附完整代码示例与关键注意事项。
本文详解 android 应用因未正确处理运行时定位权限（如 access_fine_location）而引发的首次启动闪退问题，提供安全、合规的权限请求与位置获取流程，并附完整代码示例与关键注意事项。
在 Android 6.0（API 23）及以上版本中，危险权限（包括定位权限）必须在运行时动态申请，且不能在权限尚未授予时直接调用位置相关 API（如 FusedLocationProviderClient.getLastLocation() 或 requestLocationUpdates()）。你描述的现象——“首次点击‘允许’后崩溃，第二次正常”——正是典型的时间竞态问题：用户刚授予权限，但应用未等待权限回调完成就立即尝试获取位置，导致空指针或 SecurityException。
✅ 正确处理流程：三步分离法
- 检查权限状态（是否已授予）
- 按需请求权限（仅当未授予时触发 requestPermissions()）
- 在回调中安全执行位置逻辑（onRequestPermissionsResult() 或 ActivityResultLauncher）
以下为基于现代 AndroidX Activity Result API（推荐，替代已废弃的 onRequestPermissionsResult）的完整实现：
// 在 Activity 或 Fragment 中声明
private val locationPermissionLauncher = registerForActivityResult(
ActivityResultContracts.RequestPermission()
) { isGranted ->
if (isGranted) {
// ✅ 权限已授予，此时可安全获取位置
getLastKnownLocation()
} else {
// ⚠️ 用户拒绝或勾选“不再询问”
Toast.makeText(this, "定位权限被拒绝，无法获取位置", Toast.LENGTH_SHORT).show()
}
}
// 启动权限请求（例如在 onCreate 或按钮点击中）
private fun requestLocationPermission() {
if (ContextCompat.checkSelfPermission(
this,
Manifest.permission.ACCESS_FINE_LOCATION
) == PackageManager.PERMISSION_GRANTED
) {
// 已有权限，直接获取位置
getLastKnownLocation()
} else {
// 触发系统弹窗
locationPermissionLauncher.launch(Manifest.permission.ACCESS_FINE_LOCATION)
}
}
// 安全的位置获取方法（需确保权限已获）
private fun getLastKnownLocation() {
val client = LocationServices.getFusedLocationProviderClient(this)
client.lastLocation
.addOnSuccessListener { location ->
if (location != null) {
Log.d("Location", "Lat: ${location.latitude}, Lng: ${location.longitude}")
} else {
Log.w("Location", "Last known location is null")
}
}
.addOnFailureListener { e ->
Log.e("Location", "Failed to get location", e)
}
}
⚠️ 关键注意事项
- 禁止在 checkSelfPermission() 返回 true 前调用位置 API：即使你刚调用 requestPermissions()，系统也不会同步授予权限；所有位置操作必须严格置于权限回调内。
- 区分 ACCESS_FINE_LOCATION 与 ACCESS_COARSE_LOCATION：前者需精确 GPS，后者仅依赖基站/WiFi，测试阶段建议先用粗略定位降低门槛。
- 处理“拒绝且不再询问”场景：若用户勾选“不再询问”，isGranted 恒为 false，此时应引导用户手动进入设置页（使用 Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS)）。
- 适配 Android 12+（API 31）：需额外声明 ACCESS_BACKGROUND_LOCATION（后台定位），且仅在必要时申请；前台定位仍只需 ACCESS_FINE_LOCATION。
- 不要在 Application 或 ContentProvider 中初始化位置逻辑：这些组件无 UI 上下文，无法弹出权限对话框，极易导致崩溃。
✅ 总结
首次启动崩溃的本质是权限状态与业务逻辑耦合过紧。解决核心在于：将“请求权限”和“使用位置”彻底解耦，严格遵循“检查 → 请求 → 回调 → 执行”四步链路。采用 ActivityResultLauncher 不仅线程安全、生命周期感知强，还能避免 onRequestPermissionsResult 的冗余重写与 requestCode 管理混乱。务必在真实设备（非模拟器）上测试多轮授权/拒绝流程，确保鲁棒性。
