Expo SDK42开发后台定位功能已配置Info.plist仍提示缺少NSLocation项报错

问题原因 #

• iOS Info.plist 缺失必填权限描述项：仅配置了NSLocationAlwaysAndWhenInUseUsageDescription，但iOS系统和Expo SDK42的定位模块要求必须同时配置NSLocationWhenInUseUsageDescription前台权限描述，少任意一项都会触发当前报错。
• 配置修改后未重新构建客户端：Expo托管工作流下修改app.json中的原生配置后，热更新/JS重载不会同步更新原生配置，必须重新构建iOS客户端才会生效。
• 代码存在方法名拼写错误：Location.startLocationUpdateAsync少了末尾的s，正确方法名为Location.startLocationUpdatesAsync；Location.getBackgroundPositionAsync为无效方法，后台定位数据通过TaskManager回调接收，不需要单独调用该方法。
• 权限请求逻辑不符合iOS规范：iOS后台权限请求必须建立在前台权限已经授权的基础上，直接请求后台权限会被系统直接拒绝。

解决方案 #

步骤1：更新app.json的iOS配置 #

补充缺失的权限描述项：

"ios": {
  "supportsTablet": true,
  "infoPlist":{
    "NSLocationWhenInUseUsageDescription": "Allows App to use location services when the app is in use.",
    "NSLocationAlwaysAndWhenInUseUsageDescription":"Allows App to use location services in the foreground and background.",
    "NSFaceIDUsageDescription":"Allows App to use Face ID for a simpler sign in.",
    "UIBackgroundModes":[
      "location",
      "fetch"
    ]
  }
},

步骤2：修正业务代码 #

先修改定位初始化逻辑：

useEffect(()=> {
  let isActive = true;
  const initBackgroundLocation = async () =>{
    // 先请求前台权限，再申请后台权限，符合iOS权限交互逻辑
    const foregroundRes = await Location.requestForegroundPermissionsAsync();
    if(foregroundRes.status !== 'granted'){
      setErrorMsg('Permission to access location was denied');
      return;
    }
    const backgroundRes = await Location.requestBackgroundPermissionsAsync()
    if(backgroundRes.status === 'granted'){
      // 修正方法名拼写
      await Location.startLocationUpdatesAsync(LOCATION_TASK_NAME, {
        accuracy: Location.Accuracy.Balanced,
      });
    } else {
      setErrorMsg('Permission to access background location was denied')
    }
  }
  initBackgroundLocation()
  return() =>{
    isActive=false
  }
},[])

确认TaskManager代码放在组件外部，不要放在组件函数内部，原有写法逻辑正确，可补充位置处理逻辑：

// 放在组件外部，全局只执行一次
TaskManager.defineTask(LOCATION_TASK_NAME,({data,error})=>{
  if(error){
    return;
  }
  if(data){
    const{locations} = data
    // 此处补充位置数据处理逻辑，比如上传服务端、更新全局状态
  }
})

步骤3：重新构建iOS客户端 #

执行expo build:ios构建新的安装包，本地开发可执行expo run:ios生成测试客户端，修改原生配置后必须重建才会生效。

注意事项 #

• iOS13及以上系统测试时，权限弹窗需要手动选择「始终允许」，后台定位才能正常工作。
• 确保LOCATION_TASK_NAME为全局唯一字符串，不要和其他TaskManager任务重名。
• Android配置无需修改，当前权限配置符合要求。

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