【FAQ】HarmonyOS SDK 闭源开放能力 — Network Kit

1.问题描述：

在系统网络代理在被清除后，鸿蒙web组件尝试打开网页时，获取到了系统网络代理，导致网页打开失败。

解决方案：

检查网络权限配置确保在 module.json5 配置文件中已声明必要的网络权限：

"requestPermissions": [

{
复制代码
```
 "name": "ohos.permission.INTERNET"
```
},

{
复制代码
```
 "name": "ohos.permission.GET_NETWORK_INFO"
```
}

]

缺少权限可能导致网络请求被系统拦截。

调整Web组件属性在Web组件中添加以下关键属性以增强网络访问能力：

Web({

src: 'https://example.com'

})

.domStorageAccess(true) // 启用DOM存储

.fileAccess(true) // 允许文件访问

.javaScriptAccess(true) // 启用JavaScript

部分网页功能（如WebSocket）需要开启特定权限。

处理代理残留问题

清除缓存：手动清除应用缓存或重启应用，避免代理配置残留。

设置自定义UserAgent：部分网络问题可通过覆盖默认UserAgent解决：

复制代码

Web({

  src: 'https://example.com'

})

.userAgent('Mozilla/5.0 HarmonyOS-WebView')

服务端兼容性验证

若涉及跨域请求（如开发环境调用远程API），需服务端配置CORS响应头（如 Access-Control-Allow-Origin: *）。

通过Postman等工具直接测试接口，排除服务端问题。

SDK版本与网络配置

确保使用最新版SDK，旧版本可能存在网络组件兼容性问题。

检查系统全局代理设置是否完全关闭（路径：系统设置 > 网络和互联网 > 代理）。

若问题仅在Web组件中复现，而系统浏览器正常，需重点排查组件属性配置及权限声明。开发过程中可通过DevTools日志（FocusedHitDataChange 类错误）定位具体失败环节。

2.问题描述：

目前有的流量管理模块https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/net-statistics里面的api，要么是统计整个设备的，要么是统计某个应用总的，有什么办法分开统计某一个应用的蜂窝和Wi-Fi吗？

解决方案：

【解决方案】

固定时间分别获取网卡和蜂窝实时上行和下行流量，两个数值的差额即为每天设备的流量统计。

部分代码示例：

复制代码

TypeScript

import { statistics, socket } from '@kit.NetworkKit';

import { BusinessError } from '@kit.BasicServicesKit';

 

@Entry

@Component

struct Index {

  @State message: string = 'Statistics';

 

  getIfaceBytes() {

    // 获取指定网卡实时下行流量

    statistics.getIfaceRxBytes("wlan0").then((stats: number) =&gt; {

      console.log(`wlan0 down size = ${stats}`);

    });

 

    // 获取指定网卡实时上行流量

    statistics.getIfaceTxBytes("wlan0").then((stats: number) =&gt; {

      console.log(`wlan0 up size = ${stats}`);

    });

  }

 

  getCellularBytes() {

    // 获取蜂窝实时下行流量

    statistics.getCellularRxBytes((error: BusinessError, stats: number) =&gt; {

      if (error) {

        console.error(`getCellularRxBytes err, code: ${error.code}, message: ${error.message}`);

        return;

      }

      console.log(`cellular down size = ${stats}`);

    });

 

    // 获取蜂窝实时上行流量

    statistics.getCellularTxBytes((error: BusinessError, stats: number) =&gt; {

      if (error) {

        console.error(`getCellularTxBytes err, code: ${error.code}, message: ${error.message}`);

        return;

      }

      console.log(`cellular up size = ${stats}`);

    });

  }

 

  build() {

    RelativeContainer() {

      Text(this.message)

        .id('Statistics')

        .fontSize($r('app.float.page_text_font_size'))

        .fontWeight(FontWeight.Bold)

        .alignRules({

          center: { anchor: '__container__', align: VerticalAlign.Center },

          middle: { anchor: '__container__', align: HorizontalAlign.Center }

        })

        .onClick(() =&gt; {

          this.message = 'Welcome';

          this.getIfaceBytes();

          this.getCellularBytes()

        })

    }

    .height('100%')

    .width('100%')

  }

}

3.问题描述：

调用getCellularRxBytes/getCellularTxBytes接口异常，{"code":2103012,"message":"Get iface name failed"}，如何解决？

解决方案：

在使用Wi-Fi场景下，调用getCellularTxBytes会出现上述异常，切换到蜂窝流量调用即可。

4.问题描述：

手动连接无网Wi-Fi，不会弹"当前WLAN不可上网，是否继续使用此WLAN"弹窗。

解决方案：

弹框只在首次连接弹出，不会重复弹出。将热点删除后重新连接，弹框会再次弹出。

5.问题描述：

系统打开VPN导致ohso.request下载接口失败，其它RCP接口请求可以正常使用。

解决方案：

上传下载是在独立的SA进程，所以走VPN的应用不能使用ohso.request接口，RCP是在应用进程传输数据。

6.问题描述：

创建VPN时Config配置中网关地址与VPN IP地址是否可以不一致？

解决方案：

网关地址与VPN分配的IP地址不在同一网段，会出现路由失效的情况，设备无法通过默认网关转发数据，导致连接超时或无法访问目标网络。应保证网关地址和VPN IP地址在同一网段，或将网关地址置空。

7.问题描述：

调试报错码2300023，Failed to write the received data to the disk/application.这个异常是接口超5M限制了吗？有什么解决方案？

解决方案：

因为http请求中下载文件超过5M的阈值导致图片过大而报错，http发起请求的响应消息的最大字节限制默认值是510241024，设置响应数据最大字节限制为100M或是采用流式传输。

【修改建议】

方案一：maxLimit修改为100M。

ArkTS 复制代码

http.createHttp().request(url,

      {

        method: http.RequestMethod.GET,

        connectTimeout: 60000,

        readTimeout: 60000,

        maxLimit: 100 * 1024 * 1024,

      },

方案二：采用流式传输。

ArkTS 复制代码

// 在dataReceive中拼接图片数据

let imageChunks: ArrayBuffer[] = [];

httpRequest.on('dataReceive', (data: ArrayBuffer) =&gt; {

  imageChunks.push(data);

  console.info('收到分片，大小:' + data.byteLength + ' bytes');

});

httpRequest.on('dataEnd', () =&gt; {

  // 计算总长度

  let totalLength = imageChunks.reduce((sum, chunk) =&gt; sum + chunk.byteLength, 0);

  let fullImage = new Uint8Array(totalLength);

  // 拼接所有分片数据

  let offset = 0;

  for (let chunk of imageChunks) {

    fullImage.set(new Uint8Array(chunk), offset);

    offset += chunk.byteLength;

  }

  console.info('图片接收完成，总大小:' + totalLength + 'bytes');

  const base64 = btoa(String.fromCharCode(...fullImage));

  const imgSrc = `data:image/png;base64,${base64}`;

  console.info('可用于展示的图片 src:', imgSrc);

});