iOS平台Maui使用Shiny地理围栏触发超时异常问题

问题概述 #

• 已添加的地理围栏可通过_geofenceManager.GetMonitorRegions()查询到，但进入/退出围栏时OnStatusChanged无响应
• 调用_geofenceManager.RequestState(region)时抛出System.TimeoutException，提示无法获取GPS坐标
• 仅iOS平台存在该问题，Android端功能正常
• 已配置Info.plist权限及后台模式，使用Shiny模板新项目、更换iOS设备测试均复现问题

解决方案 #

1. 确保获取Always位置权限 #

iOS对后台位置服务的权限要求严格，仅WhenInUse权限无法支持地理围栏的后台触发，必须主动请求Always权限：

var accessStatus = await LocationManager.RequestAccess(AccessRequest.Always);
if (accessStatus != AccessStatus.Granted)
{
    // 处理权限拒绝逻辑，引导用户前往设置开启权限
}

注意：iOS 14及以上版本，用户需要在系统设置中手动确认Always权限，仅通过弹窗授权无法直接获取。

2. 先获取当前位置再查询围栏状态 #

RequestState超时的核心原因是系统未获取到当前GPS坐标，在调用该方法前先主动请求一次位置更新：

// 先获取当前位置，超时时间设为10秒
var currentLoc = await LocationManager.GetCurrentPosition(TimeSpan.FromSeconds(10));
if (currentLoc != null)
{
    // 再查询地理围栏状态
    var fenceState = await _geofenceManager.RequestState(region);
}

3. 遵守iOS地理围栏系统限制 #

• iOS系统限制最多同时监控20个地理围栏，超出部分不会生效
• 围栏半径建议不小于100米，过小的半径会被系统忽略或无法精准触发

4. 确认Shiny服务初始化完整 #

在MauiProgram.cs中，除了添加地理围栏服务，还需确保位置服务已注册：

builder.Services.AddShiny();
builder.Services.AddLocationServices(); // 必须添加，地理围栏依赖位置服务
builder.Services.AddGeofencing<MyGeofenceDelegate>();

5. 验证后台模式配置 #

• 打开Xcode，进入项目的Signing & Capabilities页面，确认Background Modes中已勾选Location updates（仅保留该选项即可，多余选项可能降低位置服务优先级）
• 检查Info.plist中的UIBackgroundModes配置是否仅包含location，避免冗余配置：

<key>UIBackgroundModes</key>
<array>
    <string>location</string>
</array>

测试提示 #

• 必须在真实iOS设备上测试，模拟器的位置模拟无法准确触发地理围栏事件
• 使用Xcode的Debug > Simulate Location功能模拟位置移动，验证围栏进入/退出的触发逻辑

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