React Native搭配react-native-maps调用定位接口时应用崩溃如何解决？

必现排查点 #

• 检查定位接口调用是否缺少错误回调
  90%以上的同类崩溃都是调用getCurrentPosition时仅传入成功回调，未配置错误回调捕获定位超时、权限变动、服务不可用等异常，导致异常抛到上层触发崩溃，必须补全第二参数的错误处理逻辑。
• 校验定位返回值合法性再传入地图
  定位返回的经纬度如果出现undefined/null/超出规范范围（经度±180，纬度±90），直接赋值给react-native-maps的region属性会触发原生渲染崩溃，拿到坐标后必须先做合法性校验再更新地图状态。
• 检查双库与RN版本的兼容性
  确认你使用的react-native-maps和react-native-geolocation-service版本与项目React Native版本匹配：
  • RN 0.60~0.62建议搭配react-native-geolocation-service@5.x + react-native-maps@0.27.x
  • RN 0.63+建议搭配react-native-geolocation-service@6.x + react-native-maps@1.x及以上版本
• 平台侧配置补充
  • Android 12及以上版本需要在AndroidManifest.xml中额外添加ACCESS_COARSE_LOCATION或ACCESS_FINE_LOCATION的动态申请逻辑，仅静态配置权限不生效
  • iOS端需要在Info.plist中完整配置NSLocationWhenInUseUsageDescription、NSLocationAlwaysAndWhenInUseUsageDescription权限描述，iOS14+需要额外处理用户选择模糊定位的兼容逻辑

参考正确实现代码 #

import Geolocation from 'react-native-geolocation-service';
import { check, PERMISSIONS, RESULTS } from 'react-native-permissions';

// 定位更新触发逻辑
const handleUpdateLocation = async () => {
  // 前置校验权限已授予，以Android端为例，iOS替换为对应的权限常量
  const permissionResult = await check(PERMISSIONS.ANDROID.ACCESS_FINE_LOCATION);
  if (permissionResult !== RESULTS.GRANTED) return;

  Geolocation.getCurrentPosition(
    (position) => {
      const { latitude, longitude } = position.coords;
      // 坐标合法性校验
      if (
        typeof latitude === 'number' && typeof longitude === 'number' &&
        latitude >= -90 && latitude <= 90 && longitude >= -180 && longitude <= 180
      ) {
        // 合法后再更新地图状态
        setMapRegion({
          latitude,
          longitude,
          latitudeDelta: 0.005,
          longitudeDelta: 0.005,
        });
      }
    },
    // 必须添加错误回调捕获异常
    (err) => {
      console.log('定位失败：', err.code, err.message);
    },
    {
      enableHighAccuracy: true,
      timeout: 20000,
      maximumAge: 5000,
      forceRequestLocation: true,
      showLocationDialog: true
    }
  )
}

内容的提问来源于stack exchange，提问作者Văn Giáp Hoàng