React Native Expo：startLocationUpdatesAsync后台定位失效及通知异常求助

问题描述 #

应用前台位置追踪功能正常，但调用startLocationUpdatesAsync并添加foregroundService参数后，后台无通知显示，且完全无法获取位置数据。使用Expo SDK 46，接受脱离Expo的解决方案。

核心问题排查与修复步骤 #

1. 补充Expo配置权限 #

后台定位依赖特定配置，需在app.json中添加以下内容：

• Android端：
  在expo.android.permissions数组中加入：

  "ACCESS_BACKGROUND_LOCATION",
  "FOREGROUND_SERVICE"
  

  同时添加前台服务声明：

  "expo.android.foregroundServices": {
    "location": {}
  }
  

• iOS端：
  在expo.ios.infoPlist中添加权限描述与后台模式：

  "NSLocationAlwaysAndWhenInUseUsageDescription": "需要始终获取您的位置以提供后台追踪服务",
  "NSLocationWhenInUseUsageDescription": "需要获取您的位置以提供服务",
  "UIBackgroundModes": ["location"]
  

2. 修正代码逻辑 #

（1）同步异步操作

toggleFetchTask中停止位置更新的逻辑未等待异步操作完成，导致状态检查提前执行，修正后代码：

const toggleFetchTask = async () => {
  if (isRegistered) {
    const isRunning = await Location.hasStartedLocationUpdatesAsync(BACKGROUND_FETCH_TASK);
    if (isRunning) {
      await Location.stopLocationUpdatesAsync(BACKGROUND_FETCH_TASK);
    }
  } else {
    await Location.startLocationUpdatesAsync(BACKGROUND_FETCH_TASK, {
      accuracy: Location.Accuracy.BestForNavigation,
      distanceInterval: 10, // 调整为合理值，避免过于频繁更新
      deferredUpdatesInterval: 5000, // 降低后台更新频率，减少资源消耗
      foregroundService: {
        notificationTitle: "位置追踪中",
        notificationBody: "后台正在更新您的位置",
        notificationColor: "#2196F3" // Android需指定通知颜色
      },
      showsBackgroundLocationIndicator: true,
    });
  }
  await checkStatusAsync();
};

（2）完善后台任务结果返回

后台任务需明确返回执行结果，否则可能被系统终止，修正任务定义：

TaskManager.defineTask(
  BACKGROUND_FETCH_TASK,
  async ({ data: { locations }, error }) => {
    if (error) {
      console.error("位置更新错误:", error.message);
      await TaskManager.setTaskResult(BACKGROUND_FETCH_TASK, false);
      return;
    }
    if (locations?.length > 0) {
      console.log("收到新位置:", locations);
      await TaskManager.setTaskResult(BACKGROUND_FETCH_TASK, true);
    } else {
      await TaskManager.setTaskResult(BACKGROUND_FETCH_TASK, false);
    }
  }
);

3. 脱离Expo（Bare React Native）方案 #

若切换到原生环境，需完成以下配置：

• Android端：
  在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.ACCESS_BACKGROUND_LOCATION" />
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
  

  在<application>标签内添加前台服务声明：

  <service
    android:name="com.facebook.react.modules.location.LocationService"
    android:foregroundServiceType="location" />
  

• iOS端：
  在Info.plist中添加：

  <key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
  <string>需要始终获取您的位置以提供后台追踪服务</string>
  <key>NSLocationWhenInUseUsageDescription</key>
  <string>需要获取您的位置以提供服务</string>
  <key>UIBackgroundModes</key>
  <array>
    <string>location</string>
  </array>
  

  推荐使用react-native-geolocation-service替代官方定位模块，更稳定支持后台追踪。

4. 系统层面权限验证 #

• Android：进入应用设置，确认已授予「始终允许」位置权限，部分机型需手动开启「后台活动」权限。
• iOS：进入设置→隐私与安全性→定位服务→目标应用，确认设置为「始终允许」，并开启「精确位置」。

内容的提问来源于stack exchange，提问作者karim.belhadjali