Android中GPS获取当前位置时currentLocation空指针异常问题

常见原因 #

• 异步定位未完成就调用：GPS定位是异步操作，调用obtenerCoordenadas后，MyLocationListener还没收到系统返回的位置数据，currentLocation未被赋值，直接调用getLongitude()就会触发空指针。
• 定位权限未正确获取：Android 6.0+需要动态申请ACCESS_FINE_LOCATION或ACCESS_COARSE_LOCATION权限，权限未通过时，系统不会返回位置信息。
• GPS未开启或信号弱：设备GPS关闭，或当前环境（如室内）GPS信号差，无法获取有效位置，导致currentLocation为空。
• LocationProvider配置错误：未指定使用GPS_PROVIDER，或该Provider被禁用、不可用。

具体解决方案 #

1. 等待位置回调后再处理数据 #

GPS定位结果通过onLocationChanged回调返回，不要在调用obtenerCoordenadas后立即访问currentLocation，而是在监听器内部处理位置数据：

private class MyLocationListener implements LocationListener {
    @Override
    public void onLocationChanged(Location location) {
        // 此处location为有效对象，直接使用
        double longitude = location.getLongitude();
        double latitude = location.getLatitude();
        // 后续业务逻辑，比如更新UI、保存坐标等
    }

    @Override
    public void onStatusChanged(String provider, int status, Bundle extras) {}

    @Override
    public void onProviderEnabled(String provider) {}

    @Override
    public void onProviderDisabled(String provider) {}
}

2. 确保定位权限正常 #

首先在AndroidManifest.xml中声明权限：

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

针对Android 6.0+，动态申请权限：

private static final int REQUEST_LOC_PERM = 100;

// 检查并申请权限
if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION)
        != PackageManager.PERMISSION_GRANTED) {
    ActivityCompat.requestPermissions(this,
            new String[]{Manifest.permission.ACCESS_FINE_LOCATION},
            REQUEST_LOC_PERM);
} else {
    // 权限已获取，开始定位
    obtenerCoordenadas();
}

// 处理权限申请结果
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == REQUEST_LOC_PERM) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            obtenerCoordenadas();
        } else {
            Toast.makeText(this, "需开启定位权限才能获取位置", Toast.LENGTH_SHORT).show();
        }
    }
}

3. 检查GPS状态并引导开启 #

在获取位置前，先验证GPS是否开启：

LocationManager locationManager = (LocationManager) getSystemService(Context.LOCATION_SERVICE);
boolean isGpsEnabled = locationManager.isProviderEnabled(LocationManager.GPS_PROVIDER);
if (!isGpsEnabled) {
    // 跳转到系统设置开启GPS
    Intent gpsIntent = new Intent(Settings.ACTION_LOCATION_SOURCE_SETTINGS);
    startActivity(gpsIntent);
}

4. 验证LocationProvider可用性 #

在obtenerCoordenadas中先确认GPS_PROVIDER可用：

LocationManager locationManager = (LocationManager) getSystemService(Context.LOCATION_SERVICE);
if (!locationManager.isProviderEnabled(LocationManager.GPS_PROVIDER)) {
    Toast.makeText(this, "GPS定位服务不可用", Toast.LENGTH_SHORT).show();
    return;
}
// 注册监听器开始定位
locationManager.requestLocationUpdates(LocationManager.GPS_PROVIDER, 0, 0, new MyLocationListener());

5. 强制添加空值判断 #

如果必须在回调外访问currentLocation，一定要先做非空校验：

if (currentLocation != null) {
    double longitude = currentLocation.getLongitude();
    double latitude = currentLocation.getLatitude();
    // 业务逻辑处理
} else {
    Toast.makeText(this, "无法获取当前位置，请检查GPS状态", Toast.LENGTH_SHORT).show();
}

内容的提问来源于stack exchange，提问作者Luis Daniels