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

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

获取当前网络访问状态

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

用法很简单：

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：

示例判断是否在 WiFi：

bool isOnWifi = Connectivity.Current.ConnectionProfiles.Contains(ConnectionProfile.WiFi);

注意：多个 profile 可能同时存在（如 WiFi + 蓝牙 PAN），所以要用

Contains

离线场景下的实用建议

真实用户场景中，光知道“离线”还不够，还得处理得自然：

Connectivity.Current.NetworkAccess

基本上就这些。Connectivity API 设计简洁，重点是把

NetworkAccess

ConnectionProfiles