React Native构建Release APK时定位错误的原因排查求助

1. 权限不匹配导致定位精度不足 #

你的代码中Android端请求的是ACCESS_COARSE_LOCATION权限，但同时设置了enableHighAccuracy: true——高精度定位需要ACCESS_FINE_LOCATION权限。Release模式下系统权限校验更严格，导致无法获取高精度位置，只能返回粗略的基站定位（甚至错误位置）。

• 修改权限请求逻辑：Android端改为请求PERMISSIONS.ANDROID.ACCESS_FINE_LOCATION
• 确保AndroidManifest.xml中声明对应权限：

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

2. 混淆规则破坏定位库逻辑 #

Release构建默认开启代码混淆，可能篡改了react-native-geolocation-service的内部实现，导致定位功能异常。

• 在android/app/proguard-rules.pro中添加混淆规则：

  -keep class com.agontuk.RNFusedLocation.** { *; }
  -keep interface com.agontuk.RNFusedLocation.** { *; }
  

3. 缓存机制返回旧位置 #

配置中maximumAge: 10000允许使用10秒内的缓存位置，Release模式下系统可能优先返回旧缓存，而非实时定位。

• 强制获取实时位置，将maximumAge改为0：

  {        
    enableHighAccuracy: true,
    accuracy: {
      android: 'high',
      ios: 'best',
    },
    timeout: 15000,
    maximumAge: 0, // 禁用缓存
    distanceFilter: 10,
  }
  

4. 系统定位模式限制 #

部分设备在Release模式下默认定位模式为“省电”或“仅设备”，无法提供高精度定位。

• 引导用户手动开启“高精度”定位模式，或通过代码跳转至系统定位设置页面。

5. Google Play服务兼容性问题 #

react-native-geolocation-service依赖Google Play服务的Fused Location Provider，Release模式下设备的Google Play服务版本过低或未安装会导致定位失败。

• 在应用中添加Google Play服务版本检查，提示用户更新或安装。

6. 签名与API密钥不匹配 #

如果应用使用了Google定位相关API，Debug和Release签名的SHA-1指纹不同会导致Release版本无法正常调用服务。

• 检查Google Cloud控制台，确保已添加Release版本的SHA-1指纹并关联正确的API密钥。

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