如何正确组织 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()）协调执行，即可彻底规避竞态问题，提升应用稳定性与用户体验。