如何正确组织 Android 中异步位置权限与地图初始化的执行顺序
本文详解如何避免因过早调用依赖定位权限的方法（如 getLastKnownLocation()）导致应用崩溃，通过合理设计异步流程、延迟地图初始化，并统一入口点确保 currentLocation 和 GoogleMap 在就绪后才协同工作。
本文详解如何避免因过早调用依赖定位权限的方法（如 `getlastknownlocation()`）导致应用崩溃，通过合理设计异步流程、延迟地图初始化，并统一入口点确保 `currentlocation` 和 `googlemap` 在就绪后才协同工作。
在 Android 开发中，位置权限请求（ActivityCompat.requestPermissions）和 FusedLocationProviderClient.getLastLocation() 均为异步操作——它们不会阻塞主线程，也不会立即返回结果。而你的 onCreate() 方法却在未等待权限授予或定位获取完成的情况下，直接调用 getLastKnownLocation() 并尝试初始化地图，这正是应用首次启动或 GPS 关闭时崩溃的根本原因：currentLocation 为 null，后续调用 currentLocation.getLatitude() 触发 NullPointerException。
✅ 正确做法：统一初始化入口，延迟执行依赖逻辑
核心原则是：所有依赖位置数据与地图就绪的操作，必须在两者均可用后才执行。不应在 onCreate() 中提前调用 getLastKnownLocation() 或 getMapAsync() 相关逻辑，而应将其封装为可复用的初始化方法，并仅在安全时机触发。
1. 提取地图与位置联合初始化逻辑
将原本分散在 onCreate() 和 OnSuccessListener 中的地图准备代码，统一提取为 initMapAndLocation() 方法：
private void initMapAndLocation() { // 确保 Fragment 已存在且 Map 尚未加载 if (suppMapFragment == null) { suppMapFragment = (SupportMapFragment) getSupportFragmentManager() .findFragmentById(R.id.maps); } if (suppMapFragment != null && mMap == null) { suppMapFragment.getMapAsync(this); }}
2. 权限与位置获取流程重构
- fetchLastLocation() 不再直接调用 getMapAsync()，而是专注获取位置，并在成功后触发统一初始化；
- onRequestPermissionsResult() 授权成功后，也调用同一初始化入口；
- onMapReady() 中不再重复获取位置，仅负责地图渲染与 UI 设置（此时 currentLocation 应已可靠赋值）。
修改后的关键方法如下：
private void fetchLastLocation() { if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED) { ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, REQUEST_CODE); return; // ✅ 立即返回，不继续执行 } Task<Location> task = client.getLastLocation(); task.addOnSuccessListener(location -> { if (location != null) { currentLocation = location; initMapAndLocation(); // ✅ 位置就绪 → 启动初始化 } else { // 可选：回退到 getLastKnownLocation() 或提示用户手动触发 currentLocation = getLastKnownLocation(); initMapAndLocation(); } }).addOnFailureListener(e -> { Log.e("MainActivity", "Location fetch failed", e); currentLocation = getLastKnownLocation(); initMapAndLocation(); });}@Overridepublic void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) { super.onRequestPermissionsResult(requestCode, permissions, grantResults); if (requestCode == REQUEST_CODE) { if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) { fetchLastLocation(); // ✅ 授权后重新尝试获取位置 } else { Toast.makeText(this, "Location permission denied. Map may not show your position.", Toast.LENGTH_LONG).show(); // 即使无权限，仍可初始化地图（仅禁用 my-location 功能） initMapAndLocation(); } }}
3. onMapReady() 保持简洁与健壮
此时 currentLocation 已由前述流程保障非空（或有合理 fallback），onMapReady() 仅聚焦地图配置：
@Overridepublic void onMapReady(@NonNull GoogleMap googleMap) { this.mMap = googleMap; // ✅ 安全使用 currentLocation —— 它已在 initMapAndLocation() 前被赋值 LatLng latLng = currentLocation != null ? new LatLng(currentLocation.getLatitude(), currentLocation.getLongitude()) : new LatLng(0.0, 0.0); // fallback center MarkerOptions markerOptions = new MarkerOptions() .position(latLng) .title("You are here!"); googleMap.moveCamera(CameraUpdateFactory.newLatLngZoom(latLng, 12)); googleMap.addMarker(markerOptions); googleMap.getUiSettings().setMyLocationButtonEnabled(true); if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED) { googleMap.setMyLocationEnabled(true); }}
⚠️ 注意事项与最佳实践
- 永远不要在 onCreate() 中直接调用 getLastKnownLocation() 并假设其返回非空：系统可能无缓存位置，尤其首次安装或重启后。
- CheckGps() 调用时机需谨慎：当前代码在 onCreate() 和 onMapReady() 中重复调用，建议移至 fetchLastLocation() 开头或用户主动触发（如按钮点击），避免干扰主流程。
- 空值防御不可省略：即使做了流程控制，currentLocation 仍可能为 null（如用户拒绝权限且无历史位置），onMapReady() 中应提供默认坐标或 UI 提示。
- 避免在 onMapReady() 内再次调用 fetchLastLocation() 或权限请求：这会造成逻辑嵌套与状态混乱，所有前置条件应在进入 onMapReady() 前完成。
通过将“位置获取 → 地图初始化”解耦为受控的异步链路，并以单一入口（initMapAndLocation()）协调执行，即可彻底规避竞态问题，提升应用稳定性与用户体验。
