Ionic3中mauron85 BackgroundGeolocation插件启动延迟及后台追踪问题

我之前在项目里也踩过这个插件的坑，结合你的配置和描述来看，主要是参数设置和系统权限/行为的问题，给你几个实用的调整方向：

1. 更换更高效的位置提供者 #

你当前用的locationProvider: 0对应旧的Android原生位置提供者，它的启动速度和后台稳定性都不如专门针对运动场景优化的ACTIVITY_PROVIDER。建议改成：

locationProvider: BackgroundGeolocationProvider.ACTIVITY_PROVIDER, // 对应数值1

这个提供者会结合设备的运动传感器来智能调整位置更新频率，既省电又能更快进入主动追踪状态。

2. 优化定位参数（避免系统限制） #

你的参数设置过于激进：stationaryRadius:1、distanceFilter:1、interval:1000，这种高频高精度的请求会触发Android的后台资源限制机制，导致系统延迟甚至拒绝位置更新。建议调整为更合理的数值：

desiredAccuracy: 20, // 降低精度要求，平衡速度与耗电
stationaryRadius: 20, // 静止时超过20米才重新触发追踪
distanceFilter: 10, // 移动10米以上才更新位置
activitiesInterval: 10000, // 每10秒检测一次设备活动状态
interval: 5000, // 位置更新间隔设为5秒

3. 关键：处理权限与启动时机 #

• 必须确保权限齐全：Android 10+需要ACCESS_BACKGROUND_LOCATION权限，iOS需要在Info.plist中配置NSLocationAlwaysAndWhenInUseUsageDescription。启动插件前一定要先请求并确认权限已获取，比如用cordova-plugin-android-permissions检查权限：

import { AndroidPermissions } from '@ionic-native/android-permissions';

// 示例：请求位置权限
this.androidPermissions.requestPermissions([
  this.androidPermissions.PERMISSION.ACCESS_FINE_LOCATION,
  this.androidPermissions.PERMISSION.ACCESS_BACKGROUND_LOCATION
]).then(() => {
  // 权限获取成功后再启动插件
  this.initBackgroundGeolocation();
});

• 启动前检查位置服务状态：避免在位置服务未开启时启动插件，浪费资源：

this.backgroundGeolocation.isLocationEnabled().then(enabled => {
  if (enabled) {
    this.backgroundGeolocation.start();
  } else {
    this.backgroundGeolocation.showLocationSettings(); // 引导用户开启位置服务
  }
});

4. 后台运行的必要配置 #

• Android前台服务：Android 8+要求后台定位必须使用前台服务，确保配置里加上：

foregroundService: true,

同时在config.xml中添加对应的权限：

<config-file parent="/*" target="AndroidManifest.xml">
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
</config-file>

• 调用finish()方法：每次收到位置更新后，必须调用finish()告诉系统你已处理完位置数据，否则Android会逐渐限制更新频率：

this.backgroundGeolocation.configure(config).subscribe(location => {
  console.log("Background location", location);
  this.lat = location.latitude;
  this.lng = location.longitude;
  // 关键：调用finish()
  this.backgroundGeolocation.finish();
});

5. 系统层面的注意事项 #

• 关闭电池优化：很多国产Android厂商（小米、华为、OPPO等）的电池优化会强制限制后台应用的位置更新，测试时务必把你的应用加入电池优化白名单。
• 用真实设备测试：模拟器的位置更新机制和真实设备差异很大，插件的后台行为在模拟器上往往不准确。

修改后的完整配置示例 #

import { BackgroundGeolocation, BackgroundGeolocationConfig, BackgroundGeolocationResponse, BackgroundGeolocationProvider } from '@ionic-native/background-geolocation';
import { AndroidPermissions } from '@ionic-native/android-permissions';

constructor(
  private backgroundGeolocation: BackgroundGeolocation,
  private androidPermissions: AndroidPermissions
) {
  this.requestPermissionsAndInit();
}

private requestPermissionsAndInit() {
  this.androidPermissions.requestPermissions([
    this.androidPermissions.PERMISSION.ACCESS_FINE_LOCATION,
    this.androidPermissions.PERMISSION.ACCESS_BACKGROUND_LOCATION
  ]).then(() => {
    this.initBackgroundGeolocation();
  }).catch(error => {
    console.error('Permission request failed:', error);
  });
}

private initBackgroundGeolocation() {
  let config: BackgroundGeolocationConfig = {
    locationProvider: BackgroundGeolocationProvider.ACTIVITY_PROVIDER,
    desiredAccuracy: 20,
    stationaryRadius: 20,
    distanceFilter: 10,
    activitiesInterval: 10000,
    interval: 5000,
    notificationTitle: 'TiCaccio is tracking you',
    notificationText: 'you know it, right?',
    foregroundService: true,
    stopOnTerminate: false, // 可选：应用终止后继续追踪
    startOnBoot: true // 可选：开机自动启动追踪
  };

  this.backgroundGeolocation.configure(config).subscribe(
    (location: BackgroundGeolocationResponse) => {
      console.log("Background location", location);
      this.lat = location.latitude;
      this.lng = location.longitude;
      this.backgroundGeolocation.finish();
    },
    (error) => {
      console.error('Background geolocation error:', error);
    }
  );

  this.backgroundGeolocation.isLocationEnabled().then(enabled => {
    if (enabled) {
      this.backgroundGeolocation.start();
      console.log('Background geolocation started successfully');
    } else {
      this.backgroundGeolocation.showLocationSettings();
    }
  });
}

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