本文详解如何避免因过早调用依赖定位权限的方法（如 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();
});
}
@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 {
Toast.makeText(this, "Location permission denied. Map may not show your position.",
Toast.LENGTH_LONG).show();
// 即使无权限，仍可初始化地图（仅禁用 my-location 功能）
initMapAndLocation();
}
}
}</location>
3. onMapReady() 保持简洁与健壮
此时 currentLocation 已由前述流程保障非空（或有合理 fallback），onMapReady() 仅聚焦地图配置：
@Override
public 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()）协调执行，即可彻底规避竞态问题，提升应用稳定性与用户体验。
