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：完全无网络连接

用法很简单：

实时监听网络变化事件

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

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

Access global ocean tides model. Functions include tide height at a given date/time/location, tide extrema, and grid weather data.

访问全球海洋潮汐模型。功能包括查询指定日期、时间和地点的潮高、潮汐极值及格点天气数据。

下载

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

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

• ConnectionProfile.WiFi
• ConnectionProfile.Cellular
• ConnectionProfile.Ethernet
• ConnectionProfile.Unknown

示例判断是否在 WiFi：

注意：多个 profile 可能同时存在（如 WiFi + 蓝牙 PAN），所以要用 Contains 而非直接比对。

离线场景下的实用建议

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

• 界面层加个轻量提示条（非弹窗），2 秒后自动收起
• API 请求失败时，先检查 Connectivity.Current.NetworkAccess，再决定重试 or 缓存队列
• 本地数据库操作照常执行，等联网后再同步（配合 依赖注入 封装同步逻辑）
• iOS 模拟器偶尔返回不准确状态，真机测试更可靠

基本上就这些。Connectivity API 设计简洁，重点是把 NetworkAccess 和 ConnectionProfiles 的语义理解清楚，别把它当成“是否有信号”来用。