Android 15及新版本获取用户位置的问题排查与实现指南

一、具体排查步骤 #

1. 权限配置检查 #

• 核对AndroidManifest.xml，确保已声明必要权限：
  • Android 10+后台定位：ACCESS_BACKGROUND_LOCATION
  • 前台精确定位：ACCESS_FINE_LOCATION
  • 粗略定位（可选）：ACCESS_COARSE_LOCATION
• 注意：Android 12+禁止同时请求ACCESS_FINE_LOCATION和ACCESS_COARSE_LOCATION，需根据需求二选一
• 检查运行时权限请求逻辑：是否在代码中动态发起权限请求，且正确处理用户的授权结果（允许/拒绝/仅使用时允许）

2. 定位服务状态验证 #

• 通过代码检查系统定位服务是否开启：

  LocationManager locationManager = (LocationManager) getSystemService(Context.LOCATION_SERVICE);
  boolean gpsEnabled = locationManager.isProviderEnabled(LocationManager.GPS_PROVIDER);
  boolean networkEnabled = locationManager.isProviderEnabled(LocationManager.NETWORK_PROVIDER);
  

• 若服务未开启，引导用户跳转到系统设置页面开启：

  Intent intent = new Intent(Settings.ACTION_LOCATION_SOURCE_SETTINGS);
  startActivity(intent);
  

3. 代码逻辑调试 #

• 确认位置回调注册成功：检查requestLocationUpdates的参数（更新间隔、最小位移、回调实例）是否符合需求
• 添加日志输出：在权限请求回调、位置更新回调中打印关键信息，比如权限状态、定位结果、错误码
• 验证定位优先级：Android 10+建议使用FusedLocationProviderClient并设置Priority.PRIORITY_HIGH_ACCURACY，确保获取高精度位置

二、新Android版本位置权限正确处理 #

Android 10（API 29）及以上 #

• 区分前台与后台定位权限：
  • 前台定位：请求ACCESS_FINE_LOCATION或ACCESS_COARSE_LOCATION，仅在应用处于前台时生效
  • 后台定位：需先获得前台定位权限，再单独请求ACCESS_BACKGROUND_LOCATION，且必须向用户说明后台定位的用途
• 权限请求不能一次性发起前台+后台权限，需分两步完成

Android 12（API 31）及以上 #

• 用户授权新增「仅使用时允许」选项，该选项仅允许应用在前台运行时获取位置
• 禁止同时请求精确定位和粗略定位，需明确选择其中一类权限发起请求
• 后台定位权限申请需满足：应用已获得前台定位权限，且弹窗说明后台定位的具体场景

三、兼容性问题解决方法 #

• 改用FusedLocationProviderClient：替代旧的LocationManagerAPI，它会自动适配不同Android版本的定位策略，提升兼容性和定位精度
• 动态适配权限请求：根据系统版本调整请求的权限集合：

  String[] permissions;
  if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
      permissions = new String[]{Manifest.permission.ACCESS_FINE_LOCATION, Manifest.permission.ACCESS_BACKGROUND_LOCATION};
  } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
      permissions = new String[]{Manifest.permission.ACCESS_FINE_LOCATION};
  } else {
      permissions = new String[]{};
  }
  requestPermissions(permissions, LOCATION_REQUEST_CODE);
  

• 处理权限拒绝场景：当用户拒绝权限并勾选「不再询问」时，引导用户跳转到应用设置页面手动开启权限
• 定位 fallback 策略：当GPS定位超时或失败时，自动切换到网络定位，确保能获取到近似位置

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