如何在 Android 中正确协调位置权限请求与地图初始化的执行顺序

本文详解如何避免因异步权限请求未完成就执行地图初始化而导致的崩溃，通过重构代码逻辑确保 onMapReady() 调用前 currentLocation 已安全获取，并统一管理权限、GPS 状态与地图加载流程。

Android 开发里，位置权限和地图初始化都是典型的异步操作，这个大家应该不陌生，但真正处理好的项目其实不多。权限请求需要用户交互才能继续，getLastLocation() 又依赖后台服务的回调，getMapAsync() 里的 onMapReady() 也不是随叫随到的。很多开发者遇到的情况是——Debug 调试时，会发现 Permission 的弹窗还没点，mMap 就已经调用了 getMapAsync，结果 currentLocation 理所当然为空，崩了。尤其是在首次安装，或者用户把 GPS 关掉的情况下，这个问题几乎必现。说到底，就是代码在 onCreate() 里同步调了 fetchLastLocation() 后，马上执行 getLastKnownLocation() 并初始化地图，导致 currentLocation 大概率是 null，随后在 onMapReady() 里访问 currentLocation.getLatitude() 时，NullPointerException 就直接把应用干掉了。

✅ 正确做法：延迟初始化，统一入口

核心原则非常明确：所有依赖位置数据的操作——包括地图标记、相机定位这些，必须在确保 currentLocation 可用之后才能执行。不要在 onCreate() 里提前调用 getLastKnownLocation() 或直接触发地图逻辑，正确的做法是把初始化封装成一个独立方法，只在下面任一条件满足时才去调用：

• 权限已授予且位置成功获取（通过 OnSuccessListener）；
• 用户在 onRequestPermissionsResult() 回调中授予了权限；
• onMapReady() 触发时二次校验位置的有效性。

// ✅ 提取地图初始化逻辑为独立方法
private void setupMapWithLocation() {
    if (currentLocation == null) {
        // 可选：显示加载提示或默认视图
        Toast.makeText(this, "Waiting for location...", Toast.LENGTH_SHORT).show();
        return;
    }
    suppMapFragment = (SupportMapFragment) getSupportFragmentManager()
            .findFragmentById(R.id.maps);
    if (suppMapFragment != null) {
        suppMapFragment.getMapAsync(this);
    }
}

// ✅ 修改 fetchLastLocation：移除 onCreate 中的冗余调用
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; // ⚠️ 此处不再调用 CheckGps() 或其他依赖位置的逻辑！
    }
    Task task = client.getLastLocation();
    task.addOnSuccessListener(location -> {
        if (location != null) {
            currentLocation = location;
            setupMapWithLocation(); // ✅ 成功获取位置后才初始化地图
        } else {
            // 位置不可用时的降级处理（如触发定位请求）
            requestLocationUpdates();
        }
    }).addOnFailureListener(e -> {
        Log.e("Location", "Failed to get last location", e);
        Toast.makeText(this, "Location una vailable", Toast.LENGTH_SHORT).show();
    });
}

? 关键修复点与注意事项

1. 移除 onCreate() 中的危险调用
   删除 currentLocation = getLastKnownLocation(); 和 suppMapFragment.getMapAsync(this); —— 它们在权限未获准时必然返回 null，而且跟 fetchLastLocation() 的异步流程冲突。

2. onMapReady() 中禁止重复获取位置
   当前 onMapReady() 内再次调用 getLastKnownLocation() 是冗余且危险的（权限可能仍被拒绝）。应改为：

   @Override
   public void onMapReady(@NonNull GoogleMap googleMap) {
       this.mMap = googleMap;
       CheckGps(); // 仅检查GPS开关，不阻塞地图渲染
       if (currentLocation == null) {
           // 显示占位提示，或触发定位请求
           Toast.makeText(this, "Location not a vailable yet", Toast.LENGTH_LONG).show();
           return;
       }
       LatLng latLng = new LatLng(currentLocation.getLatitude(), currentLocation.getLongitude());
       googleMap.addMarker(new MarkerOptions().position(latLng).title("You are here!"));
       googleMap.moveCamera(CameraUpdateFactory.newLatLngZoom(latLng, 12));
       // ... 其他地图配置
   }
   

3. 权限拒绝后的用户体验
   在 onRequestPermissionsResult() 中需处理拒绝场景：

   @Override
   public 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 {
               // ❌ 明确告知用户功能受限
               new AlertDialog.Builder(this)
                   .setTitle("Location Permission Required")
                   .setMessage("This app needs location access to show your position.")
                   .setPositiveButton("Grant", (d, w) -> 
                       ActivityCompat.requestPermissions(this, 
                           new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, REQUEST_CODE))
                   .setNegativeButton("Cancel", null)
                   .show();
           }
       }
   }
   

4. CheckGps() 的优化建议
   当前 CheckGps() 在 onMapReady() 中每次调用，容易触发重复弹窗。建议改为：

   • 在 fetchLastLocation() 前调用一次；
   • 或在 onResume() 中检查，避免地图加载期间干扰用户。

? 总结

Android 的异步特性要求开发者主动管理执行时序：永远不要假设 onCreate() 中的代码会按线性顺序“等待”异步结果。正确的架构是：

• 将业务逻辑（如地图初始化）封装为可重入方法；
• 仅在所有前置条件（权限、位置、地图就绪）满足后触发；
• 对每种失败路径（拒绝权限、GPS关闭、无位置数据）提供明确反馈。

通过上述重构，应用将稳定运行于首次启动、权限拒绝、GPS关闭等所有边界场景，彻底规避 NullPointerException 崩溃。