Flutter中使用Geolocator如何监听应用运行时位置服务状态

Geolocator 本身内置了系统位置服务状态的监听能力，不需要引入额外第三方库就能实现需求，具体实现步骤如下：

前置准备 #

先确认pubspec.yaml中引入的geolocator为稳定版本（建议^10.0.0及以上），同时配置好Android、iOS端的基础定位权限：

• Android端在AndroidManifest.xml中添加精确定位权限声明
• iOS端在Info.plist中添加对应场景的定位权限描述文案

核心实现代码 #

核心使用Geolocator.getServiceStatusStream()提供的流实现实时监听，该流会在系统层面的位置服务总开关（GPS/位置信息开关）状态变化时，推送最新的状态值。
注意：冷启动时流不会主动推送初始状态，需要先主动获取一次当前服务状态，避免初始状态判断错误。

import 'package:flutter/material.dart';
import 'package:geolocator/geolocator.dart';
import 'dart:async';

class LocationServiceDemo extends StatefulWidget {
  const LocationServiceDemo({super.key});

  @override
  State<LocationServiceDemo> createState() => _LocationServiceDemoState();
}

class _LocationServiceDemoState extends State<LocationServiceDemo> {
  StreamSubscription<ServiceStatus>? _serviceStatusSubscription;
  bool _locationServiceEnabled = false;

  @override
  void initState() {
    super.initState();
    // 初始化获取当前位置服务状态
    _getInitialServiceStatus();
    // 注册状态监听
    _registerServiceStatusListener();
  }

  // 获取初始状态
  Future<void> _getInitialServiceStatus() async {
    _locationServiceEnabled = await Geolocator.isLocationServiceEnabled();
    // 启动时如果位置服务已经开启，直接执行对应业务逻辑
    if (_locationServiceEnabled) {
      _runLocationDependentLogic();
    }
    if (mounted) setState(() {});
  }

  // 注册服务状态监听
  void _registerServiceStatusListener() {
    _serviceStatusSubscription = Geolocator.getServiceStatusStream().listen((event) {
      final isEnabled = event == ServiceStatus.enabled;
      setState(() {
        _locationServiceEnabled = isEnabled;
      });

      if (isEnabled) {
        // 监听到位置服务开启，自动执行业务逻辑：比如拉取当前位置、刷新周边数据、请求定位权限等
        _runLocationDependentLogic();
      } else {
        // 监听到位置服务关闭，执行对应逻辑：比如暂停定位请求、提示用户定位相关功能暂不可用
        _handleServiceDisabled();
      }
    });
  }

  // 自定义的定位相关业务逻辑
  void _runLocationDependentLogic() {
    debugPrint('位置服务已开启，执行定位关联流程');
    // 这里写你的业务代码，比如获取当前位置、加载附近内容等
  }

  // 位置服务关闭时的处理逻辑
  void _handleServiceDisabled() {
    debugPrint('位置服务已关闭，暂停定位相关任务');
  }

  @override
  void dispose() {
    // 页面销毁时取消订阅，避免内存泄漏
    _serviceStatusSubscription?.cancel();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('位置服务监听示例')),
      body: Center(
        child: Text(
          _locationServiceEnabled ? '当前位置服务已开启' : '当前位置服务未开启',
          style: const TextStyle(fontSize: 18),
        ),
      ),
    );
  }
}

常见踩坑说明 #

• 这个流监听的是系统层面的位置总开关状态，和App自身的定位权限状态是独立的，如果需要同时监听定位权限变化，可以搭配Geolocator.getPermissionStatusStream()使用，不要把两个状态混为一谈。
• 不需要额外监听App生命周期来刷新状态：用户跳转到系统设置开关位置服务后回到App，流会自动收到最新的状态回调，不需要在resume生命周期重复调用方法查询状态。
• 如果需要引导用户开启位置服务，直接调用Geolocator.openLocationSettings()即可跳转到系统位置设置页，不需要自己实现跨平台跳转逻辑。
• 不要重复注册监听：如果是全局需要监听状态，可以在应用根节点的State中注册一次即可，多个页面重复订阅会导致业务逻辑重复执行。
• 对于不需要定位就能使用的功能，完全可以在状态为关闭时不做强制拦截，等监听到服务开启后再自动执行定位相关逻辑，符合非强依赖的产品需求。

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