uni.onNetworkStatusChange 是唯一实时监听入口，但仅前台生效，需每次 onShow 重新注册；uni.getNetworkType 仅为一次性快照，无法感知后续变化，须组合使用并加防抖与状态锁。
uni.onNetworkStatusChange 是唯一实时监听入口，但只在前台生效
它不是轮询，而是系统网络栈切换时的被动通知。ios 和 android 真机上必须在 onshow 中注册才稳定；切到后台后回调立即停止，这是系统限制，不是 bug。微信小程序完全不支持该 api，h5 下始终返回 networktype: 'unknown'，别在浏览器里测逻辑。
常见失效场景包括：App 启动后没触发 onShow 就进页面、iOS 未开启「后台运行」权限、Android 定制 ROM（如华为 EMUI）限制后台广播。解决方案是每次 onShow 都重新调用 uni.onNetworkStatusChange 注册，避免监听句柄丢失。
为什么不能只靠 uni.getNetworkType 判断断网
uni.getNetworkType 是一次性快照，冷启动时安卓部分机型可能返回 'unknown'（网络栈未就绪），iOS 在无网时可能延迟 2–3 秒才回调，导致页面白屏。它无法感知后续变化——用户连上 WiFi 后，页面状态不会自动更新。
真正要捕获「从有到无」，必须配合 uni.onNetworkStatusChange。推荐组合：onLaunch 和 onShow 中都调一次 uni.getNetworkType 做初始值，再立刻用 uni.onNetworkStatusChange 接管后续变化。
防抖 + 状态锁是避免重复弹窗的关键
地铁穿隧道、WiFi DHCP 延迟等场景会导致 isConnected 在 true/false 间快速跳变。直接每次触发都 uni.showToast，用户会看到连环提示。
- 用一个全局变量（如
window.__networkAlertLocked）做锁，提示中设为true，3 秒内再次触发直接 return - 更稳妥的是只在
isConnected从true变为false的瞬间提示，需缓存上一次状态比对 - 别用
uni.showModal做首次断网提示——阻塞操作；优先用uni.showToast或顶部 banner
iOS 权限和跳转限制必须提前处理
iOS 要求开启定位权限才能获取准确网络类型，否则 networkType 恒为 'none' 或 'unknown'。manifest.json 中必须配置 NSLocationWhenInUseUsageDescription，且用户手动授权后才有效。
uni.openSetting 在 iOS 上打不开 Wi-Fi 设置页，只打开当前 App 的权限设置页。文案别写“前往网络设置”，应改为“前往系统设置 → 手动开启 Wi-Fi/蜂窝数据”。Android 可自定义引导页，iOS 则必须加一句明确提示：“iOS 系统限制，需手动返回设置开启网络”。
最常被忽略的一点：网络状态变化 ≠ 业务可用。即使 isConnected: true 且 networkType: 'wifi'，你也得自己发一个轻量请求（比如 GET /health）验证能否通内网服务——这才是考勤打卡、IoT 控制等场景的生死线。
