Android获取GPS当前位置：模拟器正常真机无返回，代码遗漏项排查

问题排查及解决方案 #

1. 权限请求异步逻辑缺失 #

ActivityCompat.requestPermissions是异步调用，不会阻塞后续代码执行，你在申请权限后直接注册位置监听，此时用户还未完成授权操作，会导致监听注册失败。模拟器可能已经提前授予过定位权限，所以可以正常运行，真机首次安装时就会出现无响应的问题。
修复方案：
重写Fragment的onRequestPermissionsResult回调，只有确认用户授予定位权限后，再执行位置监听注册逻辑。
同时需在AndroidManifest.xml中声明对应的权限：

<!-- 基础定位权限 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- 地址解析需要联网 -->
<uses-permission android:name="android.permission.INTERNET" />
<!-- 若有后台定位需求，适配Android 10及以上需额外添加 -->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

2. 定位Provider覆盖场景不足 #

你仅注册了GPS_PROVIDER的监听，该Provider依赖卫星信号，在室内、有遮挡的场景下很难搜星成功，不会触发onLocationChanged回调。模拟器支持模拟GPS信号所以运行正常，真机日常使用场景下很容易出现无返回的问题。
修复方案：
同时注册网络定位Provider的监听，代码示例：

// 权限申请通过后执行
locationManager = (LocationManager) getContext().getSystemService(Context.LOCATION_SERVICE);
// 注册GPS定位监听
if (locationManager.isProviderEnabled(LocationManager.GPS_PROVIDER)) {
    locationManager.requestLocationUpdates(LocationManager.GPS_PROVIDER, 1000, 3, mLocationListener);
}
// 注册网络定位监听
if (locationManager.isProviderEnabled(LocationManager.NETWORK_PROVIDER)) {
    locationManager.requestLocationUpdates(LocationManager.NETWORK_PROVIDER, 1000, 3, mLocationListener);
}

3. 反向地址解析异常未处理 #

Geocoder.getFromLocation方法需要联网才能正常返回地址，且返回的地址列表可能为空，你当前直接调用moradas.get(0)会在列表为空时抛出索引越界异常，被catch后不会执行后续的Toast和变量赋值逻辑。
修复方案：
增加空判断逻辑：

try {
    Geocoder geocoder = new Geocoder(getContext(), Locale.getDefault());
    List<Address> moradas = geocoder.getFromLocation(location.getLatitude(), location.getLongitude(), 1);
    // 增加非空判断
    if (moradas != null && !moradas.isEmpty()) {
        moradaAtual = moradas.get(0).getAddressLine(0);
        Toast.makeText(getContext(), "Morada: " + moradaAtual, Toast.LENGTH_LONG).show();
    } else {
        Toast.makeText(getContext(), "未获取到地址信息，请检查网络连接", Toast.LENGTH_LONG).show();
    }
} catch (Exception e) {
    e.printStackTrace();
    Toast.makeText(getContext(), "地址解析失败：" + e.getMessage(), Toast.LENGTH_LONG).show();
}

4. Release包混淆规则缺失 #

模拟器默认运行Debug版本，一般不会开启混淆，而打包正式APK时如果开启了混淆，没有添加定位相关的保留规则会导致LocationListener回调被混淆，无法正常触发。
修复方案：
在proguard-rules.pro文件中添加如下混淆规则：

-keep class android.location.** {*;}
-keep class * implements android.location.LocationListener {*;}

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