文档开发者中心
我的
|

HarmonyOS 5

鸿蒙对网络是否可用的检测是依赖外网吗?

20

先叠甲,

我这边用的鸿蒙的定制手机,插入流量卡设置APN走的运营商的内网通道,

结果现在通过鸿蒙系统的网络判定 在写业务之前判断了下,这里返回的一直都是false。

async checkInternetConnection(): Promise<boolean> {

    try {

      const netHandler = await connection.getDefaultNet();

      const capabilities = await connection.getNetCapabilities(netHandler);

      this.initNetArea(capabilities)

      const hasInternet = capabilities.networkCap.includes(connection.NetCap.NET_CAPABILITY_INTERNET);

      const isValidated = capabilities.networkCap.includes(connection.NetCap.NET_CAPABILITY_VALIDATED);

      return hasInternet && isValidated;

    } catch (error) {

      Logger.error('Failed to get network status:', error);

      return false;

    }

  }

内网情况下访问不了外网,所以就怀疑这个的网络可用判断是基于纯外网的吗?如果是内网的这种环境下 怎么处理呢?

点赞
收藏
回复
5
分享
举报
浏览139 发布于2026-04-23 07:36北京
全部评论
最多点赞
最新发布
最早发布
|
技术支持
尊敬的开发者,您好,
关于您反馈的问题,
需要依赖外网,官网文档描述中已经说明了NET_CAPABILITY_VALIDATED是通过访问华为云站点来判断的,如果你是由于内网通道无法访问华为云站点,就不会有这个能力标注。
可以自己通过ping或者其他网络连接内网支持访问的站点,判断内网的连通性,参考以下:
  • 使用connection中的NetCap的字段'NET_CAPABILITY_VALIDATED'判断网络访问Internet的连通性是否被网络管理成功验证,该能力由网络管理模块设置。

  • 使用三方库@ohos-rs/ping检测ip地址/网址是否连通。

  • 对于新完成连接的网络,由于网络正在进行连通性验证,此值可能无法反映真实的验证结果。对此,可以通过'NET_CAPABILITY_CHECKING_CONNECTIVITY'检查网络是否正在检测连通性。

  • ping之后的网络相关数据可以通过OH_NetConn_QueryProbeResult查询网络探测结果获取。

  • ping之后的网络相关数据通过OH_NetConn_QueryProbeResult不会超时返回,导致进程Block。可以通过OH_NetConn_QueryProbeResult的第2个参数duration(类型为int32_t)设置探测操作的超时时间,以毫秒(ms)为单位的超时阈值。未设置超时(传0)会导致永久阻塞。


 
5楼回复于2026-04-27 05:47 来自广东

上面你说是鸿蒙定制手机,插流量卡走运营商内网 APN,是无法访问外网服务器地址的,所以 NET_CAPABILITY_VALIDATED 的返回总是false。

两者有区别:

NET_CAPABILITY_INTERNET : 检测是否有联网路由能力

NET_CAPABILITY_VALIDATED: 检测能否联通外网

看上面代码,第一步没啥问题connection.NetCap.NET_CAPABILITY_INTERNET  检查是否有网络连接,

若这一步都检测不通过,直接就返回false, 没有后续检测的必要

否则,后面换一个方式检验: 直接访问项目业务服务器地址, 可以访问拿到正常响应说明网络通畅

3楼回复于2026-04-25 01:16 来自湖南

是的,你这个判断里用到的 NET_CAPABILITY_VALIDATED 在“内网不通外网”的专网/APN 场景下,很容易一直是 false——因为它不是“能不能访问你们内网”的验证,而是系统网络管理去做联网验证。

在鸿蒙的定义里:

  • NET_CAPABILITY_INTERNET:表示该网络“应具有访问 Internet 的能力”,由网络提供者设置,但连通性并未被网络管理成功验证。
  • NET_CAPABILITY_VALIDATED:表示网络管理通过该网络与华为云地址成功建立连接(也就是系统做过外部连通性验证)。
    所以你的专网无法访问外网/无法访问系统用于校验的华为云地址时,VALIDATED 就会一直拿不到。
    Sources: @ohos.net.connection(网络连接管理) NetCap 定义

你现在这种“只要能访问内网就算可用”,建议怎么做?

方案 1:不要用 VALIDATED 做业务前置条件

把判断改成“有链路 + 有 IP +(可选)有默认路由”,再由业务自己探测内网服务是否可达。

收起
自动换行
深色代码主题
复制
import { connection } from '@kit.NetworkKit'

async function hasNetworkLink(): Promise<boolean> {
  const net = await connection.getDefaultNet()
  const caps = await connection.getNetCapabilities(net)
  const props = await connection.getConnectionProperties(net)

  const hasIp = (props.linkAddresses?.length ?? 0) > 0
  return hasIp
}

注意:如果你们的 APN 网络连 NET_CAPABILITY_INTERNET 都不会被运营商/系统标记,那 getDefaultNet() 可能拿不到你期望的那张网(文档里默认网要求具备 INTERNET 能力)。这时就用 getAllNets() 遍历找蜂窝网/你想要的网络再做后续判断。

方案 2:自己做“内网可用性”探测(推荐)

用 http/socket 去访问你们内网一个稳定的 healthcheck 地址(比如 http://intranet-gw/health 或你们天气接口域名),成功才认为“网络可用”。

核心思路:

  1. 先判断链路/有 IP
  2. 再探测你们内网目标(超时要短,比如 1~2s)
  3. 用探测结果作为“可用性”,不要依赖 VALIDATED

方案 3(如果你能定制系统/ROM):让系统的“VALIDATED 校验地址”可达

如果你们是定制机且能改系统侧网络管理策略,理论上可以:

  • 放行系统联网验证要访问的地址,或
  • 将验证地址改为你们内网探测地址,或
  • 关闭这类外网验证逻辑
    但这属于系统侧能力,应用侧一般做不到。
展开全部
4楼回复于2026-04-26 00:47 未知归属地

NET_CAPABILITY_VALIDATED 返回 false是正常的啊, 系统判断的是能不能访问互联网,而不是有没有数据连接,

NET_CAPABILITY_VALIDATED 是ping 通了才反馈true 

2楼回复于2026-04-23 13:46 来自北京

首先回答你前面的问题,依赖外网。你代码中的用的这两个能力:

NET_CAPABILITY_INTERNET // 理论上可以访问外网

NET_CAPABILITY_VALIDATED // 系统实际检测到【能上外网】

系统底层会自动访问:

connectivitycheck.platform.hicloud.com

  • 或 http://clients3.google.com/generate_204
  • 能通 → VALIDATED = true不能通(内网)→ VALIDATED = false

    所以:你的代码在内网环境,永远返回 false。

然后是你的业务需求问题:你这算是定制场景下的网络判断,我建议你直接判断内网是否联通即可。

收起
自动换行
深色代码主题
复制
  try {
    const netHandler = await connection.getDefaultNet();
    // 内网核心:只判断是否连接,不验证外网
    return netHandler.isConnected === true; 
  } catch (error) {
    Logger.error('网络检测失败', error);
    return false;
  }
1楼回复于2026-04-23 08:54 来自湖北
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。