Flutter锁屏状态下无法获取后台位置，遇权限异常求助

问题重现 #

开发一款无需地图、需每分钟获取一次位置的Flutter应用，锁屏或应用进入后台后无法获取位置，出现以下错误：

I/flutter (13751): PlatformException(SERVICE_STATUS_ERROR, Location service status couldn't be determined, null, null)
获取位置时出现 -> PlatformException(PERMISSION_DENIED, Background location permission denied, null, null)

已尝试插件：flutter_background 1.2.0、flutter_background_geolocation: ^4.10.2、background_fetch: ^1.1.5、background_location: ^0.8.1、flutter_background_service 2.4.6，均未解决。

核心解决方案 #

一、权限配置（Android+iOS）

权限不全是后台定位失败的最常见根源，必须确保前台+后台定位权限全部申请通过。

Android 配置

1. Manifest 权限添加：在android/app/src/main/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" />
<!-- Android 12+ 需通知权限用于前台服务 -->
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
<!-- 申请忽略电池优化权限 -->
<uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS" />

同时注册前台服务（Android 8+强制要求）：

<service
    android:name="com.transistorsoft.flutter.backgroundgeolocation.HeadlessTask"
    android:enabled="true"
    android:exported="false"
    android:foregroundServiceType="location" />

2. 动态权限申请：使用permission_handler插件请求永久定位权限（而非仅前台权限）：

import 'package:permission_handler/permission_handler.dart';

Future<void> requestAllPermissions() async {
  // 请求永久定位权限（包含前台+后台）
  final locationStatus = await Permission.locationAlways.request();
  if (locationStatus.isDenied || locationStatus.isPermanentlyDenied) {
    await openAppSettings();
  }
  // 请求忽略电池优化权限
  final batteryStatus = await Permission.ignoreBatteryOptimizations.request();
  if (!batteryStatus.isGranted) {
    await openAppSettings();
  }
  // Android 12+ 请求通知权限
  if (await Permission.notification.isDenied) {
    await Permission.notification.request();
  }
}

iOS 配置

1. Info.plist 权限描述：在ios/Runner/Info.plist中添加：

<key>NSLocationWhenInUseUsageDescription</key>
<string>需要获取您的位置信息以提供服务</string>
<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>应用需要在后台持续获取您的位置信息</string>
<key>NSLocationBackgroundUsageDescription</key>
<string>应用需要在后台持续获取位置信息</string>

2. 动态权限申请：同样请求永久定位权限：

final status = await Permission.locationAlways.request();
if (!status.isGranted) {
  await openAppSettings();
}

二、插件正确使用（以flutter_background_geolocation为例）

该插件是目前最成熟的后台定位解决方案，之前可能因配置不全导致失效：

1. 初始化与配置：

import 'package:flutter_background_geolocation/flutter_background_geolocation.dart' as bg;

void initBackgroundLocation() async {
  // 初始化核心配置
  bg.BackgroundGeolocation.ready(bg.Config(
    desiredAccuracy: bg.Config.DESIRED_ACCURACY_HIGH,
    distanceFilter: 0, // 忽略距离变化，仅按时间触发
    interval: 60000, // 每分钟获取一次位置（单位：毫秒）
    stopOnTerminate: false, // 应用被杀后继续运行
    startOnBoot: true, // 设备重启后自动启动定位
    enableHeadless: true, // 启用无头模式（应用被杀后仍能执行任务）
    foregroundService: true, // Android强制要求前台服务
    notificationTitle: "位置更新中",
    notificationText: "应用正在后台获取您的位置",
  )).then((bg.State state) {
    if (!state.enabled) {
      bg.BackgroundGeolocation.start(); // 启动定位服务
    }
  });

  // 监听位置更新回调
  bg.BackgroundGeolocation.onLocation((bg.Location location) {
    // 处理位置数据：location.coords.latitude / location.coords.longitude
    print("新位置：${location.coords.latitude}, ${location.coords.longitude}");
  });

  // 监听定位错误
  bg.BackgroundGeolocation.onError((bg.Error error) {
    print("定位错误：${error.code} - ${error.message}");
  });
}

2. 无头模式配置：在Android的MainApplication.java中注册无头任务（确保应用被杀后仍能触发定位）：

// MainApplication.java
import com.transistorsoft.flutter.backgroundgeolocation.BackgroundGeolocationPlugin;
import io.flutter.app.FlutterApplication;

public class MainApplication extends FlutterApplication {
  @Override
  public void onCreate() {
    super.onCreate();
    BackgroundGeolocationPlugin.registerHeadlessTask(new HeadlessTask());
  }
}

三、处理系统限制（重点针对国产ROM）

小米、华为、OPPO等国产ROM有严格的后台进程限制，需引导用户手动设置：

• 允许应用自启动
• 将应用加入后台白名单（无限制后台运行）
• 关闭应用的电池优化
• 部分机型需开启悬浮窗权限（保障前台服务通知正常显示）

四、解决SERVICE_STATUS_ERROR错误

该错误通常因设备位置服务未开启导致，可在代码中提前检测：

import 'package:location/location.dart';

Future<bool> checkLocationServiceStatus() async {
  Location location = Location();
  bool serviceEnabled = await location.serviceEnabled();
  if (!serviceEnabled) {
    serviceEnabled = await location.requestService();
    if (!serviceEnabled) {
      // 引导用户前往设置开启位置服务
      return false;
    }
  }
  return true;
}

总结 #

后台定位失败的核心原因通常是权限不全、系统后台限制或插件配置错误。优先检查权限配置，再针对不同平台调整插件参数，最后处理国产ROM的特殊限制即可解决问题。

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