.NET MAUI后台服务实现求助：iOS适配与后台定位API调用失败

原方案失败的排查要点 #

• 先查权限配置：iOS必须在Info.plist里加NSLocationAlwaysAndWhenInUseUsageDescription、NSLocationWhenInUseUsageDescription两个权限描述，还要开启后台模式里的「Location updates」
• 验证服务注册：确认MauiProgram.cs里正确注册了定位相关服务，比如AddSingleton<LocationService>()
• 后台启动逻辑：iOS不允许纯后台启动定位，必须先在前台获取一次定位权限，再切换后台才能持续运行
• API调用问题：后台发请求要注意iOS网络限制，要么用HTTPS，要么在Info.plist里配置NSAppTransportSecurity允许HTTP；另外HttpClient要复用单例，别每次请求都新建

iOS后台定位手动实现步骤 #

1. 配置Info.plist #

直接在Platforms/iOS/Info.plist里添加以下内容：

<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>需要持续定位以提供服务</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>需要定位以提供服务</string>
<key>UIBackgroundModes</key>
<array>
    <string>location</string>
</array>

2. 写定位服务逻辑 #

创建一个LocationService类，用MAUI自带的Geolocation API：

public class LocationService
{
    private CancellationTokenSource _cts;
    private readonly HttpClient _httpClient;

    public LocationService(HttpClient httpClient)
    {
        _httpClient = httpClient; // 依赖注入HttpClient，避免重复创建
    }

    public async Task StartTracking()
    {
        // 先请求WhenInUse权限，再请求Always（iOS 13+要求）
        var whenInUseStatus = await Permissions.RequestAsync<Permissions.LocationWhenInUse>();
        if (whenInUseStatus != PermissionStatus.Granted) return;

        var alwaysStatus = await Permissions.RequestAsync<Permissions.LocationAlways>();
        if (alwaysStatus != PermissionStatus.Granted) return;

        _cts = new CancellationTokenSource();
        var request = new GeolocationRequest(GeolocationAccuracy.Medium, TimeSpan.FromSeconds(15));
        // 开启后台监听
        await Geolocation.StartListeningAsync(request, OnLocationUpdated, _cts.Token);
    }

    private async void OnLocationUpdated(Location location)
    {
        if (location == null) return;
        // 调用你的API
        var locationData = new { Lat = location.Latitude, Lng = location.Longitude };
        var json = JsonSerializer.Serialize(locationData);
        var content = new StringContent(json, Encoding.UTF8, "application/json");
        try
        {
            await _httpClient.PostAsync("你的API地址", content);
        }
        catch (Exception ex)
        {
            // 处理请求失败，比如本地缓存后重试
        }
    }

    public void StopTracking()
    {
        _cts?.Cancel();
    }
}

3. 注册并启动服务 #

在MauiProgram.cs里注册服务：

builder.Services.AddHttpClient<LocationService>(); // 注入HttpClient
builder.Services.AddSingleton<LocationService>();

在MainPage的OnAppearing里启动：

protected override async void OnAppearing()
{
    base.OnAppearing();
    var locationService = MauiProgram.Services.GetRequiredService<LocationService>();
    await locationService.StartTracking();
}

4. iOS额外注意事项 #

• iOS 13+必须先请求WhenInUse权限，用户同意后才能请求Always权限，直接请求Always会被拒绝
• 后台定位的更新间隔别太短，建议10秒以上，太频繁会被系统限制甚至杀死进程
• 如果需要更稳定的后台运行，可以考虑用BGTaskScheduler实现后台任务刷新，但定位场景优先用Location后台模式

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