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：
- ConnectionProfile.WiFi
- ConnectionProfile.Cellular
- ConnectionProfile.Ethernet
- ConnectionProfile.Unknown
示例判断是否在 WiFi：
bool isOnWifi = Connectivity.Current.ConnectionProfiles.Contains(ConnectionProfile.WiFi);
注意：多个 profile 可能同时存在（如 WiFi + 蓝牙 PAN），所以要用 Contains 而非直接比对。
离线场景下的实用建议
真实用户场景中，光知道“离线”还不够，还得处理得自然：
- 界面层加个轻量提示条（非弹窗），2 秒后自动收起
- API 请求失败时，先检查
Connectivity.Current.NetworkAccess，再决定重试 or 缓存队列 - 本地数据库操作照常执行，等联网后再同步（配合 依赖注入 封装同步逻辑）
- iOS 模拟器偶尔返回不准确状态，真机测试更可靠
基本上就这些。Connectivity API 设计简洁，重点是把 NetworkAccess 和 ConnectionProfiles 的语义理解清楚，别把它当成“是否有信号”来用。
