URLError.dataNotAllowed与notConnectedToInternet触发场景区别

URLError.notConnectedToInternet 触发场景 #

• 设备网络接口已激活，但无有效公网路由：包括设备未连接任何Wi-Fi/蜂窝网络、已连接Wi-Fi但路由器上游断网、蜂窝网络有信号但运营商侧无公网连接、VPN隧道异常导致无有效外网路由等情况，系统网络栈可明确判定当前不存在连通公网的路径，发起请求时会抛出该错误。
• 请求传输过程中网络中断：dataTask已启动并处于数据传输阶段时，设备突然从联网状态切换为无网状态（如离开Wi-Fi覆盖范围、进入无信号区域导致蜂窝网络断开），运行中的任务失败会返回该错误。
• 目标地址无可达路由：即使设备本身有公网连接，但到请求目标域名/IP的路由完全不可达时，也可能触发该错误。

两类错误的核心差异 #

两类错误的本质区别是错误触发的系统层级完全不同：

• notConnectedToInternet 属于 网络连通性层错误：核心判定逻辑是「网络路径不通」，错误触发时请求已经进入网络协议栈的路由寻址/数据传输环节，系统确认不存在能到达目标的有效网络路径才会返回。
• URLError.dataNotAllowed 属于 系统访问策略层错误：核心判定逻辑是「网络访问被拦截」，错误触发于请求的前置校验阶段，根本不会进入后续的路由寻址环节，触发原因是系统规则禁止当前App/当前请求发送网络数据，和当前是否实际存在可用网络无关。

dataNotAllowed 常见触发场景包括：

• App被用户在系统设置中关闭了所有网络访问权限
• 当前仅接入蜂窝网络，但App被设置为仅允许Wi-Fi环境联网
• 系统开启低数据模式，当前请求不符合低数据模式下的网络放行规则
• 设备处于飞行模式时，系统直接拦截所有出站网络请求，这是无网状态下启动dataTask收到该错误的典型场景

内容的提问来源于stack exchange，提问作者iroh