文档开发者中心
我的
|

HarmonyOS 7

connection.hasDefaultNet 网络连接未认证, 网络是不可用的,但是返回true

已解决
connection.hasDefaultNet 网络连接未认证, 网络是不可用的,但是返回true
点赞
3
收藏
1
回复
9
分享
举报
浏览224 发布于2026-08-08 04:00广东
全部评论
最多点赞
最新发布
最早发布
|
采纳答复

`hasDefaultNet()` 的语义是“默认数据网络是否已激活”,并不等价于“网络已通过互联网认证”或“目标服务器一定可达”。因此,设备连上无外网的 Wi-Fi、处于门户认证页等情况下,也可能返回 `true`。

可以继续检查默认网络的能力:

```

import { connection } from '@kit.NetworkKit';

async function isValidatedDefaultNet(): Promise<boolean> {

  if (!await connection.hasDefaultNet()) {

    return false;

  }

  const netHandle = await connection.getDefaultNet();

  const caps = await connection.getNetCapabilities(netHandle);

  const netCaps = caps.networkCap ?? [];

  return netCaps.includes(connection.NetCap.NET_CAPABILITY_INTERNET) &&

    netCaps.includes(connection.NetCap.NET_CAPABILITY_VALIDATED) &&

    !netCaps.includes(connection.NetCap.NET_CAPABILITY_PORTAL);

}

```

其中 `NET_CAPABILITY_VALIDATED` 表示系统已验证该网络可用,`NET_CAPABILITY_PORTAL` 表示需要门户认证(该枚举从 API 12 提供)。调用这些接口需要声明 `ohos.permission.GET_NETWORK_INFO`;真正发起网络请求还需要 `ohos.permission.INTERNET`。

如果要持续监听状态,使用 `connection.createNetConnection()` 监听 `netCapabilitiesChange`、`netLost`,并配对调用 `register()`/`unregister()`。另外,即使网络已验证,也不能保证某个业务域名可达;业务层最好再对自己的轻量接口做一次带超时的真实请求。

展开全部
2
1楼回复于2026-08-08 04:09 未知归属地
  • 追光而行
    优秀
    2026-08-08 08:13 来自山东
  • 󾓭
    学习
    2026-08-08 09:18 来自北京
学习了
7楼回复于2026-09-07 06:58 来自广东
学习了
6楼回复于2026-08-10 01:18 来自浙江

hasDefaultNet不能满足需求的话,看下如何判断当前网络能否上网

5楼回复于2026-08-08 07:38 来自北京
好
4楼回复于2026-08-08 06:49 来自江西

补充一个实用的最佳实践方案:

在实际开发中,推荐使用分层检测策略来判断网络真正可用性:

第一层:快速判断

使用 connection.hasDefaultNet() 做初步筛选,如果返回 false 则直接认为无网络。这一步开销很小,适合高频调用。

第二层:能力检测

当 hasDefaultNet() 返回 true 时,进一步检查 NetCapabilities,特别是 NET_CAPABILITY_VALIDATED 标志位。这个标志位表示系统已经验证过该网络的互联网连通性。

第三层:业务级探测

即使通过了前两层检测,也不能保证目标服务器一定可达。建议对关键业务接口做一个轻量级的 HEAD 请求,设置 3-5 秒超时,作为最终确认。

另外提醒:不要忘记在 module.json5 中声明 ohos.permission.GET_NETWORK_INFO 和 ohos.permission.INTERNET 权限。同时,建议使用 connection.createNetConnection() 注册网络状态监听器,在 netLost 事件中及时切换到离线模式,提升用户体验。

3楼回复于2026-08-08 04:37 来自湖北
同问
2楼回复于2026-08-08 04:29 来自河南
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

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