Ionic Capacitor应用后台模式不生效，锁屏5分钟后停止运行怎么办？

• 安卓权限补全：除了电池优化权限，你需要在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" />
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE_LOCATION" />
  <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
  <uses-permission android:name="android.permission.WAKE_LOCK" />
  

  注意安卓12及以上版本，必须用户主动授予「始终允许定位」权限，否则后台定位会被系统直接拦截。
• Cordova Background Mode 配置补全：你调用的优化方法需要在正确的激活流程下才能生效，完整的初始化流程如下：

  // 先配置前台通知，安卓必须展示前台通知才能保留后台进程
  this.backgroundMode.setDefaults({
    title: "定位上报运行中",
    text: "应用正在后台上传位置信息",
    icon: "res://drawable/icon", // 替换为你的应用图标路径
    silent: false,
    visibility: 'public'
  })
  // 激活后台模式
  this.backgroundMode.enable()
  // 再调用优化方法
  this.backgroundMode.disableWebViewOptimizations()
  this.backgroundMode.disableBatteryOptimizations()
  

• 定时器逻辑替换：不要使用JS原生setInterval实现定时上报，锁屏后WebView线程会被系统冻结，定时器完全失效。你需要改用原生级别的后台任务调度插件，比如@capacitor/background-runner，将上报逻辑注册为原生后台周期任务，不依赖JS线程运行。
• Foreground Service 绑定逻辑：确认你已经将GPS定位、API上报的逻辑绑定到Foreground Service的生命周期，而不是和App的WebView生命周期绑定。如果Foreground Service没有绑定核心业务逻辑，系统会判定服务无实际作用，运行一段时间后自动回收。
• iOS 专属配置（如果适配iOS）：需要在Info.plist中添加后台定位权限声明：

  <key>UIBackgroundModes</key>
  <array>
    <string>location</string>
  </array>
  <key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
  <string>需要始终允许定位以在后台上报位置信息</string>
  

  同时在定位初始化时开启allowsBackgroundLocationUpdates属性，否则iOS锁屏后定位会自动暂停。
• 插件兼容性排查：如果你使用的是Capacitor 4/5版本，cordova-background-mode存在已知的兼容性问题，建议替换为Capacitor官方的@capacitor/background-runner插件，原生层实现的后台任务调度稳定性远高于Cordova兼容层插件。

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