酒店的 Wi-Fi 连上了,信号也满格。打开 App,页面却一直提示“网络异常”。切回设置,明明写着“已连接”。用户很难不怀疑:到底是谁判断错了?
这类问题里,“连上网络”和“能访问服务”经常被写成同一个状态。于是,App 看见 Wi-Fi 就把错误提示收起来,请求一失败又弹出来。用户还没弄清楚原因,提示已经来回变了几次。
排查可以从一个很小的问题开始:页面上这句“网络已连接”,究竟依据什么显示?
Wi-Fi 图标只能回答一部分问题
手机连上路由器,说明无线连接已经建立。路由器有没有接通外网、酒店认证是否完成、业务接口能否访问,还需要其他证据。
Android 的网络能力里,INTERNET 表示网络被配置为可以访问互联网;VALIDATED 表示系统探测时确认了公共互联网访问能力;CAPTIVE_PORTAL 表示系统探测到了需要认证的门户。VALIDATED 也不保证某个业务接口随时可用。
识别出认证门户时,可以提示用户完成 Wi-Fi 登录。一次系统探测没有通过,也不代表所有业务请求都必然失败。企业内网服务、探测地址受限等环境,需要按业务实际情况处理。

图 1|三个判断各有范围。系统验证通过以后,业务请求仍然需要自己的成功或失败结果。
别让一个布尔值决定整个页面
不少项目有一个全局变量:isNetworkAvailable。它被登录页、列表页、下载页一起使用。变量一变成 false,所有按钮都被禁用。
问题在于,这个变量丢掉了原因。暂时没有默认网络、Wi-Fi 需要认证、当前接口超时,最后全变成了“无网络”。用户看到的提示一样,能采取的操作却不同。
我会先把提示改到具体操作上:列表请求失败,就在列表里保留重试入口;网络仍在验证,就别急着宣布“网络已恢复”;确认需要认证,再引导用户处理 Wi-Fi 登录。已经展示的内容可以保留,不必跟着一条网络回调消失。
系统状态也会变化。App 如果只在启动时查一次,之后拿到的就是旧信息。可以通过 NetworkCallback 监听变化,并在能力变化回调里更新判断;收到 onAvailable 时,不要直接把它等同于互联网验证通过。
一次请求的结果只对那次请求负责。一个图片地址失败,不能顺手把已经正常工作的文本接口也判成不可用。
测试时,保留“连着”的样子
只开飞行模式,很难发现上述问题。飞行模式会让连接状态明显变化,而我们要观察的是:手机看起来还连着,业务却已经走不通。
可以用两组独立用例验证。第一组在受控 Wi-Fi 环境中进行:手机保持连接,让路由器暂时失去外网出口;如果有认证门户,再分别检查认证前后。第二组保持正常联网,只让目标 App 的流量失败。
后一组可以借助我们开发的「弱网管家」。在首页先选择待测应用,再使用丢包模板,观察请求失败时的页面提示。指定应用很有必要,否则当前界面提示的默认行为是对所有应用执行测试。

图 2|Pixel 6 实拍。首页可选择待测应用与“100%丢包”模板;截图时尚未开启模拟。
这组用例能检查 App 是否把“连接存在”误当成“请求一定成功”。它不能代替酒店认证门户,也不保证会改变系统的 VALIDATED 标记。记录时应分别写下系统状态和业务结果,不能拿其中一个猜另一个。
还可以单独加入延迟,观察请求仍在等待时,页面会不会过早提示“已断网”。慢请求和失败请求,最好各有一轮。

图 3|上下行参数可以分别配置。这里展示配置入口,数值均为默认值;带宽 0 表示不额外限速,延迟 0 表示不额外增加延迟。
把提示语也写进验收结果
验收记录里,别只写“请求超时”。把页面提示和能否继续操作也记下来。
| 测试条件 | 重点观察 |
|---|---|
| Wi-Fi 已连接,外网出口不可用 | 页面是否误报“网络正常”,失败后是否有可用的重试入口 |
| Wi-Fi 等待认证 | 是否给出与认证相关的提示,避免反复催用户检查信号 |
| 系统验证通过,目标请求失败 | 是否仅更新相关区域,保留其他可用内容 |
| 请求很慢但尚未结束 | 是否把等待错误地说成断网,是否允许用户离开当前操作 |
记录里再带上发生时间、当前默认网络、能力变化和请求结果,开发才有办法对齐事件。网络状态回调和接口回调可能交错到达,按日志打印顺序猜因果并不稳妥。
下次用户说“我明明有网”,可以先看失败页面究竟依据哪条信息给出了判断。提示如果能准确说明当前操作的情况,用户往往不需要自己在 App 和系统设置之间来回找答案。
博客深入剖析移动应用中‘Wi-Fi已连接’与‘业务可访问’被错误等同的问题,指出Android网络能力标识(如CAPABILITY_INTERNET、NET_CAPABILITY_VALIDATED)的局限性,强调业务请求需独立验证;提出避免全局布尔值控制UI、分场景测试(如断外网但保Wi-Fi连接、定向丢包)、监听网络能力变化、分离系统状态与业务结果等关键实践,提升网络异常提示的准确性与用户体验。
3177

被折叠的 条评论
为什么被折叠?



