Xamarin Essentials Connectivity.ConnectivityChanged事件触发两次如何解决

问题本质 #

该问题是Xamarin.Essentials 1.7.3（该库最终正式版，后续无官方修复）的底层实现缺陷导致：

• iOS端同时注册了系统网络权限变更、实际网络接口状态变更两个系统回调
• Android端同时接收系统网络连通性广播、网络能力变更两个系统回调
  单次网络状态切换时，两个底层回调会先后触发，最终导致上层ConnectivityChanged事件连续触发两次，该问题在iOS/Android模拟器上可稳定复现，部分真机场景也会出现。

可落地方案 #

方案1：状态校验+防抖拦截（推荐，零侵入、无兼容问题） #

不要直接将业务逻辑绑定到原生事件，新增一层拦截逻辑过滤重复触发即可，实现成本最低：

1. 定义全局变量缓存上一次生效的网络状态、最后一次事件触发时间
2. 事件触发时先做两层校验：当前上报的网络状态和缓存状态一致则直接拦截；距离上次有效触发不足300ms也直接拦截
3. 校验通过后再更新缓存、执行业务逻辑
   参考实现代码：

// 全局缓存字段
private static NetworkAccess _lastValidStatus = Connectivity.NetworkAccess;
private static DateTimeOffset _lastValidTriggerTime = DateTimeOffset.MinValue;

// 初始化绑定事件
Connectivity.ConnectivityChanged += Connectivity_OnChanged;

private void Connectivity_OnChanged(object sender, ConnectivityChangedEventArgs e)
{
    // 过滤同状态重复回调
    if (e.NetworkAccess == _lastValidStatus)
        return;
    // 过滤短时间窗口内的重复触发
    if (DateTimeOffset.Now - _lastValidTriggerTime < TimeSpan.FromMilliseconds(300))
        return;

    // 更新缓存
    _lastValidStatus = e.NetworkAccess;
    _lastValidTriggerTime = DateTimeOffset.Now;

    // 执行实际业务逻辑
    YourNetworkChangeBusinessMethod(_lastValidStatus);
}

方案2：自行封装平台原生监听 #

如果不想引入防抖逻辑，可以直接放弃使用Xamarin.Essentials封装的连通性事件，分别在平台项目实现原生监听：

• iOS端使用NWPathMonitor监听网络状态变化
• Android端自定义ConnectivityManager.NetworkCallback注册系统监听
  在原生层做好状态去重后，再通过依赖服务传递给跨端项目使用，该方案可控性最高，但需要编写平台特定代码。

方案3：迁移到维护中的替代库 #

Xamarin.Essentials已停止官方维护，若项目允许技术栈升级，可迁移至.NET MAUI，对应MAUI Essentials版本的连通性组件已修复该重复触发问题。

注意：不要通过「触发后立刻取消事件订阅、延迟再重新订阅」的方式处理重复触发，该方案会导致弱网场景下的事件丢失，引发网络状态判断错误。

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