全屏断网组件须由父组件传入响应式isConnected prop，禁用内部自行判断；v-if控制渲染，z-index≥1080；iOS无法通过uni.openSetting跳Wi-Fi页，需引导手动操作；防重复弹窗需全局锁变量；初始值须用uni.getNetworkType同步快照填充。
全屏断网组件怎么传响应式状态才不卡死
组件必须接收 isConnected 作为响应式 prop，不能靠内部调用 uni.getNetworkType 自行判断。否则在页面切换、onShow 触发时，组件可能还没拿到最新状态，导致“明明已联网却还显示断网”。isConnected 应由父级（如 App.vue）统一管理并向下透传。
常见错误是把组件写成「自治型」：自己监听 + 自己查状态 + 自己控制显隐。结果多个实例互相干扰，z-index 层叠错乱，甚至因重复注册 uni.onNetworkStatusChange 导致内存泄漏。
- 确保父组件的
isConnected是 ref 或 reactive 数据，且在onShow和onLaunch中主动更新 - 组件内用
v-if="!isConnected"控制渲染，不用v-show——后者仍会挂载 DOM，影响性能和 z-index 计算 -
z-index值建议设为1080起，避开 uni-app 内部弹窗（如uni.showToast默认 2000，但uni.showModal在某些平台实际渲染层低于 1000）
点击“去设置”后 iOS 为什么没跳转 Wi-Fi 页面
uni.openSetting 在 iOS 上根本不会打开 Wi-Fi 设置页，它只打开当前 App 的权限设置页，里面没有网络开关。这是系统限制，不是 API 失效。很多开发者真机测试失败后反复改代码，其实问题出在预期上。
正确做法是文案和行为分离：
- 弹窗按钮文字别写“前往网络设置”，改写为“前往系统设置 → 手动开启 Wi-Fi/蜂窝数据”
- 点击后调用
uni.openSetting，仅作 fallback；成功回调里不跳转，只记录日志 - Android 可额外加路由跳转：
uni.navigateTo({ url: '/pages/settings/network' })，自定义引导页说明操作路径 - 务必在
fail回调中加console.error，否则上线后完全无法定位用户是否点了按钮却无反应
多页面同时触发断网弹窗，怎么防重复堆叠
网络请求封装层（如 request.js）里直接调 uni.showModal，极易在 tab 切换、下拉刷新、路由跳转瞬间触发多次弹窗。用户点一次“取消”，下一秒又弹一个，体验极差。
核心是引入全局锁变量，且控制重置时机：
- 声明全局变量
networkModalShow = false（推荐挂到Vue.prototype或uni.$global） - 弹窗前先判断
if (!networkModalShow) { networkModalShow = true; ... } - 在弹窗
success回调里，用setTimeout(() => { networkModalShow = false; }, 1000)延迟重置，避免用户连点导致状态错乱 - 若当前是 tabBar 页面，
confirm后用uni.reLaunch而非uni.redirectTo，否则可能跳进空白页（首页 tab 缓存机制导致）
组件里“点击刷新”按钮该调什么 API
别直接调 uni.reLaunch 或 location.reload()。前者会丢失路由参数，后者在小程序里不生效，H5 下还会闪白屏。
真正该做的是触发一次网络状态快照 + 主动通知业务层重试：
- 按钮点击时调
uni.getNetworkType，拿到最新networkType，立即更新isConnected - 同时触发自定义事件，比如
uni.$emit('network-refresh')，让正在等待数据的页面自行决定是否重发请求 - 如果组件绑定了
@retry事件，就在此处this.$emit('retry')，交由父组件处理逻辑，而不是组件自己发起请求 - 避免在组件内硬编码
uni.request——这会让组件失去复用性，也破坏了关注点分离
真实项目里最常被忽略的，是 isConnected 的初始值。App 启动时它往往是 undefined，组件一上来就渲染断网 UI，哪怕网络其实正常。这个空窗期必须用 getNetworkType 的同步快照填上，不能等监听回调。
