MAUI怎么监听网络状态变化 MAUI Connectivity教程

MAUI 监听网络状态变化核心依赖 Microsoft.Maui.Essentials.Connectivity，它跨平台、免权限、无需原生代码；通过 NetworkAccess 判断互联网可达性（Internet/Local/None），用 ConnectivityChanged 事件实时响应变化，并支持 ConnectionProfiles 区分 WiFi/蜂窝等类型。

MAUI 监听网络状态变化，核心靠 Microsoft.Maui.Essentials.Connectivity，它跨平台、开箱即用，不需要额外权限（iOS/Android 侧系统已默认支持），也不用写原生桥接代码。

获取当前网络访问状态

Connectivity 提供的是“是否能访问互联网”的语义判断，不是单纯看有没有连上 WiFi 或蜂窝网。关键看 NetworkAccess 枚举：

• NetworkAccess.Internet：设备可访问公网（如能打开 google.com）
• NetworkAccess.Local：仅局域网通（比如连了 WiFi 但没网关/没外网）
• NetworkAccess.None：完全无网络连接

用法很简单：

var access = Connectivity.Current.NetworkAccess;
if (access == NetworkAccess.Internet)
    Console.WriteLine("在线，可发起 API 请求");
else if (access == NetworkAccess.Local)
    Console.WriteLine("在内网，可能无法访问云服务");
else
    Console.WriteLine("离线中");

登录后复制

实时监听网络变化事件

别轮询，用 Connectivity.ConnectivityChanged 事件——只要网络状态一变（比如断网、切 WiFi、开启飞行模式），就会触发：

// 建议在页面或服务生命周期开始时注册
Connectivity.ConnectivityChanged += OnConnectivityChanged;

void OnConnectivityChanged(object sender, ConnectivityChangedEventArgs e)
{
    var newAccess = e.NetworkAccess;
    var profile = e.ConnectionProfiles; // 如 [Wifi], [Cellular]

    if (newAccess == NetworkAccess.Internet)
        ShowOnlineToast();
    else
        ShowOfflineHint();
}

登录后复制

⚠️ 注意：该事件是全局的，记得在页面销毁或服务停用时反注册，避免内存泄漏：

Connectivity.ConnectivityChanged -= OnConnectivityChanged;

登录后复制

区分网络类型（WiFi / 蜂窝 / 以太网）

如果业务需要按网络类型做策略（例如只在 WiFi 下自动更新），用 ConnectionProfiles：

标签： android go 云服务 internet 以太网 access wifi ai ios microsoft goo