.NET MAUI（Android）如何持续运行前台服务？定位上传异常排查

针对前台服务持续运行但约一天后无法上传位置数据的问题，结合代码分析，以下是具体的原因排查和修复方案：

1. 补全前台服务启动返回值 #

你的OnStartCommand方法缺少返回值，Android系统依赖该返回值确定服务重启策略。若服务因系统资源紧张被临时回收，无正确返回值会导致服务无法恢复正常运行。

修改OnStartCommand，在方法末尾添加：

return StartCommandResult.Sticky;

该返回值会让系统在服务意外终止后尝试重启，并保留之前的Intent信息。

2. 移除异步代码中的阻塞调用 #

在OnStartCommand的Task.Run内部，你使用.Wait()阻塞线程：

locShare.RunLocation(_cts.Token).Wait();

这种同步阻塞会持续占用线程池资源，长时间运行可能导致线程耗尽，影响任务执行。改为异步等待：

await locShare.RunLocation(_cts.Token);

同时将外层委托改为异步形式：

Task.Run(async () =>
{
    Console.WriteLine("Task is running");
    try
    {
        var locShare = new GetLocationService();
        await locShare.RunLocation(_cts.Token);
    }
    catch (Exception e)
    {
        Console.WriteLine(e);
    }
}, _cts.Token);

3. 优化定位服务循环逻辑 #

RunLocation方法嵌套Task.Run会造成不必要的线程切换，且stopping变量无线程同步保护，存在线程安全问题，优化如下：

private volatile bool stopping = false;

public async Task RunLocation(CancellationToken token)
{
    try
    {
        while (!stopping)
        {
            token.ThrowIfCancellationRequested();
            await Task.Delay(5000, token);

            var request = new GeolocationRequest(GeolocationAccuracy.Medium, TimeSpan.FromSeconds(5));
            var location = await Geolocation.Default.GetLocationAsync(request, token);

            if (location != null)
            {
                var gpsData = new GpsRecord()
                {
                    Id = Guid.NewGuid(),
                    DateTime = location.Timestamp.DateTime,
                    GPSData = location.ToString(),
                    IsSync = 1,
                };

                var uploadList = new List<GpsRecord> { gpsData };
                var connectivity = Connectivity.Current;
                bool isOnline = connectivity.NetworkAccess == NetworkAccess.Internet;

                if (isOnline)
                {
                    try
                    {
                        var result = await data.PostRecordAsync(uploadList);
                        Debug.WriteLine($"[{DateTime.Now:O}] 上传结果：{result.StatusCode}");

                        if (_isOfflineSync)
                        {
                            var syncOfflineData = new SyncOfflineData();
                            await syncOfflineData.Start();
                            _isOfflineSync = false;
                        }
                    }
                    catch (Exception e)
                    {
                        Debug.WriteLine($"[{DateTime.Now:O}] 上传失败：{e.Message}");
                        gpsData.IsSync = 0;
                        await DatabaseConnectionService.AddRecordAsync(gpsData);
                        _isOfflineSync = true;
                    }
                }
                else
                {
                    _isOfflineSync = true;
                    gpsData.IsSync = 0;
                    await DatabaseConnectionService.AddRecordAsync(gpsData);
                    Debug.WriteLine($"[{DateTime.Now:O}] 无网络，数据存入本地数据库");
                }
            }
            else
            {
                Debug.WriteLine($"[{DateTime.Now:O}] 未获取到位置数据");
            }
        }
    }
    catch (OperationCanceledException)
    {
        stopping = true;
        Debug.WriteLine($"[{DateTime.Now:O}] 定位服务被取消");
    }
    catch (Exception ex)
    {
        Debug.WriteLine($"[{DateTime.Now:O}] 定位服务异常：{ex.Message}");
        await Task.Delay(1000, token);
    }
}

关键优化点：

• 移除内层Task.Run，减少线程开销
• 用volatile修饰stopping，确保多线程可见性
• 替换网络状态检测逻辑，使用Connectivity实时判断网络
• 上传失败时自动存入本地数据库，避免数据丢失
• 添加详细日志，便于问题排查

4. 确认后台定位权限与系统限制 #

Android 10+对后台定位有严格限制，需确保：

• 在AndroidManifest.xml中声明ACCESS_BACKGROUND_LOCATION权限
• 动态请求后台定位权限（需用户手动授权）
• 前台服务的通知未被用户关闭（部分厂商系统会在通知关闭后终止前台服务）

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