鸿蒙 HarmonyOS 6 | 逻辑核心 (04)：原生网络库 RCP 高性能实战

文章目录

• • • 前言
    • [一、 核心概念 Session 会话机制](#一、 核心概念 Session 会话机制)
    • [二、 极致的控制欲 DNS 优选与证书锁定](#二、 极致的控制欲 DNS 优选与证书锁定)
    • [三、 性能实战 双向流与范围下载](#三、 性能实战 双向流与范围下载)
    • [四、 总结](#四、 总结)

前言

在上一篇文章中，我们通过封装 Axios 让网络请求变得顺手且符合前端开发者的直觉。对于大多数普通的业务 CRUD 场景，Axios 确实是一把趁手的兵器，它生态丰富、API 友好。

但在鸿蒙 HarmonyOS 6 (API 20) 的深度开发中，如果我们把目光投向更底层的性能优化，或者涉及大文件并发下载、金融级安全通信等极端场景时，基于 JS 层的 Axios 或者老旧的 http 模块可能会显露出疲态。

系统为了解决这些高性能通信需求，在 API 20 中主力推崇 Remote Communication Kit （简称 RCP）。

你可能会问，既然有了 http 模块，为什么还要造一个 RCP？这不仅是 API 的迭代，更是底层实现的重构。

RCP 是完全基于 Native C++ 层构建的通信引擎，它绕过了旧版 http 模块中不必要的 JS-Native 桥接损耗，提供了更直接的系统调用路径。

我们可以把它比作一辆为赛道而生的方程式赛车，虽然驾驶难度比家用轿车稍微高一点，但它能提供的极限速度、对 DNS 的精细控制以及对 TLS 握手过程的干预能力，是普通网络库无法比拟的。

一、 核心概念 Session 会话机制

RCP 的设计哲学与传统的 http 模块有一个显著的区别，那就是 Session（会话） 的概念被极大强化了。在旧的请求模式中，我们往往是 发完即走 ，每一个 Request 都是独立的个体，想要维持 Cookie 或者共享连接池，往往需要开发者自己去维护状态。而 RCP 强制我们先创建一个 rcp.Session 对象。

这就好比我们在打电话之前，必须先建立一条稳定的专线。这个 Session 对象承载了所有的上下文信息。当我们创建一个 Session 时，我们可以配置全局的 基地址 (BaseAddress) 、请求头 (Headers) 、超时策略 甚至是 拦截器 (Interceptors)。一旦 Session 建立，后续所有的 HTTP 请求都跑在这个会话之上。

这样做最大的好处是 连接复用。RCP 底层会自动维护 TCP 连接池，当我们需要高频次地向同一个服务器发起请求时，复用的连接能极大地减少三次握手和 TLS 协商的耗时。在实测中，对于信息流加载等高并发场景，RCP 的吞吐量相比旧版 http 模块有肉眼可见的提升。

二、 极致的控制欲 DNS 优选与证书锁定

如果你做过海外应用或者金融类 App，一定遇到过 DNS 劫持或者中间人攻击的烦恼。在 JS 层的网络库中，我们很难干预 DNS 的解析过程，通常只能眼睁睁看着请求被导向错误的 IP。RCP 则赋予了我们对网络层 极致的控制欲。

在 Session 的配置项中，我们可以自定义 DnsOverHttps (DoH) 的配置。这意味着我们可以绕过运营商的 Local DNS，直接通过加密通道向 Cloudflare 或 Google 的 DNS 服务器查询 IP，彻底杜绝 DNS 污染。这对于保证应用在弱网或复杂网络环境下的连通性至关重要。

安全性方面，RCP 原生支持 证书锁定 (Certificate Pinning)。这是金融类应用的安全底线。我们可以将服务器证书的哈希值（SHA-256）预埋在客户端代码中。当 RCP 发起握手时，它会校验服务器返回的证书哈希是否与我们预埋的一致。如果不一致，哪怕证书链本身是合法的（比如被用户安装了抓包工具的根证书），连接也会被立即掐断。这种系统底层的安全校验，比我们在 JS 层做逻辑判断要可靠得多，能有效防御中间人攻击，保护用户的核心数据安全。

三、 性能实战 双向流与范围下载

除了安全和基础性能，RCP 在处理 数据流 方面也展现出了原生的优势。在下载大文件（如安装包、高清视频）时，我们通常需要支持断点续传。RCP 的 Request 对象天然支持 Range 头的高效处理。

更令人兴奋的是它的 Tracing（链路追踪） 能力。不同于 Axios 简单的请求/响应拦截，RCP 提供了基于事件的详细链路追踪。我们可以监听 DNS 解析开始、TLS 握手结束、首字节接收等微观时间节点。这对于性能调优来说是无价之宝。我们可以精确地知道一个请求慢，到底是慢在 DNS 解析上，还是慢在服务器处理上，从而进行针对性的优化。

在使用 RCP 时，我们不再是简单地传入一个 URL 和一个 JSON 对象。我们需要构建一个 rcp.Request 对象，在这个对象中，我们可以精细地控制每一个细节，比如是否允许重定向、是否通过 Cookies 等。虽然代码量看起来比 axios.get 多了几行，但换来的是对网络行为的绝对掌控。

import { rcp } from '@kit.RemoteCommunicationKit';
import { promptAction } from '@kit.ArkUI';
import { BusinessError } from '@kit.BasicServicesKit';

// -------------------------------------------------------------
// 1. RCP 服务封装类
// -------------------------------------------------------------
class RcpService {
  private session: rcp.Session;
  // 使用 httpbin.org 进行测试
  private readonly BASE_URL = 'https://httpbin.org';

  constructor() {
    // 【核心步骤】创建 Session 配置
    // 定义拦截器：RCP 的拦截器定义方式
    const logInterceptor: rcp.Interceptor = {
      intercept: async (context: rcp.RequestContext, next: rcp.RequestHandler): Promise<rcp.Response> => {
        console.info(`[RCP] Start Request: ${context.request.url.href}`);

        const response = await next.handle(context);

        console.info(`[RCP] Response Status: ${response.statusCode}`);
        return response;
      }
    };

    const sessionConfig: rcp.SessionConfiguration = {
      // 基础地址
      baseAddress: this.BASE_URL,
      // 请求头
      headers: {
        'User-Agent': 'HarmonyOS-RCP-Client/1.0',
        'Accept': 'application/json'
      },
      // 连接配置：超时时间
      requestConfiguration: {
        transfer: {
          timeout: {
            connectMs: 5000, // 连接超时 5s
            transferMs: 10000 // 传输超时 10s
          }
        }
      },
      interceptors: [logInterceptor]
    };

    // 创建会话实例
    this.session = rcp.createSession(sessionConfig);
  }

  /**
   * 发起 GET 请求
   * @param path 相对路径，如 "/get"
   */
  /**
   * 发起 GET 请求 (修复版)
   */
  /**
   * 发起 GET 请求
   */
  public async get(path: string): Promise<string> {
    try {
      if (!path) {
        throw new Error('Path cannot be empty');
      }

      const req = new rcp.Request(this.BASE_URL + path, 'GET');
      const resp = await this.session.fetch(req);

      if (resp.statusCode === 200) {
        return resp.toString() || '';
      } else {
        const code = resp.statusCode ?? 'Unknown';
        throw new Error(`HTTP Error: ${code}`);
      }
    } catch (err) {
      let errorMessage = 'Unknown Error';
      let errorCode = 'N/A';

      const systemError = err as BusinessError;

      if (systemError && systemError.code !== undefined) {
        errorMessage = systemError.message;
        errorCode = String(systemError.code);
      } else if (err instanceof Error) {
        errorMessage = err.message;
      }
      console.error(`[RCP] Request Failed: ${errorMessage}`);
      throw new Error(`Request failed: ${errorMessage} (Code: ${errorCode})`);
    }
  }
  /**
   * 关闭会话
   */
  public close() {
    this.session.close();
  }
}

// 导出单例
export const rcpClient = new RcpService();


// -------------------------------------------------------------
// 2. 界面实战：使用 RCP 获取数据
// -------------------------------------------------------------
@Entry
@Component
struct RcpDemoPage {
  @State responseData: string = '';
  @State isLoading: boolean = false;
  @State timeCost: number = 0;

  build() {
    Column() {
      // 顶部说明
      Text('原生 RCP 高性能网络')
        .fontSize(24)
        .fontWeight(FontWeight.Bold)
        .margin({ top: 40, bottom: 20 })

      // 结果展示区域
      Column() {
        if (this.isLoading) {
          LoadingProgress()
            .width(40)
            .height(40)
            .color(Color.Blue)
          Text('正在通过 Native 通道请求...')
            .fontSize(12)
            .fontColor('#999')
            .margin({ top: 10 })
        } else {
          // 性能耗时展示
          if (this.timeCost > 0) {
            Row() {
              Text('请求耗时: ')
                .fontSize(14)
                .fontColor('#333')
              Text(`${this.timeCost} ms`)
                .fontSize(14)
                .fontWeight(FontWeight.Bold)
                .fontColor('#0A59F7')
            }
            .margin({ bottom: 10 })
            .width('100%')
          }

          // 响应内容
          Scroll() {
            Text(this.responseData || '暂无数据，点击下方按钮发起请求')
              .fontSize(14)
              .fontColor(this.responseData ? '#333' : '#999')
              .lineHeight(20)
              // 允许长文本自动换行
              .textOverflow({ overflow: TextOverflow.None })
          }
          .height(200)
          .align(Alignment.TopStart)
          .width('100%')
        }
      }
      .width('90%')
      .padding(20)
      .backgroundColor(Color.White)
      .borderRadius(16)
      .shadow({ radius: 10, color: '#1A000000' })

      // 操作按钮
      Button('发起 RCP 请求 (GET)')
        .width('80%')
        .height(50)
        .margin({ top: 40 })
        .backgroundColor('#0A59F7')
        .onClick(async () => {
          this.isLoading = true;
          this.responseData = '';
          const startTime = Date.now();

          try {
            // 调用我们封装的 RCP 服务
            const result = await rcpClient.get('/get?platform=harmony_rcp');

            // 计算耗时
            this.timeCost = Date.now() - startTime;
            this.responseData = result;

            promptAction.showToast({ message: '请求成功' });
          } catch (error) {
            const err = error as BusinessError;
            promptAction.showToast({ message: `请求失败` });
            this.responseData = `Error: ${err.message}`;
          } finally {
            this.isLoading = false;
          }
        })

      Text('注：RCP 基于 Native C++ 实现，拥有比 Axios (JS层) 更高的并发性能和更细粒度的 DNS/TLS 控制能力。')
        .fontSize(12)
        .fontColor('#999')
        .padding(30)
        .textAlign(TextAlign.Center)
        .lineHeight(18)
    }
    .width('100%')
    .height('100%')
    .backgroundColor('#F1F3F5')
  }
}

四、 总结

RCP 是鸿蒙 HarmonyOS 6 为专业开发者准备的一把利刃。它也许不如 Axios 那么简单易用，生态插件也没那么丰富，但在追求极致体验的道路上，它是不可或缺的基石。对于应用中的核心业务接口、大文件传输模块以及安全敏感的支付模块，我强烈建议使用 RCP 进行重构。它能带给你更低的延迟、更稳的连接和更强的安全保障。

为了让你能快速上手，我封装了一个基于 RCP 的高性能下载器示例。这个示例展示了如何创建 Session、配置拦截器、以及如何发起一个带有详细配置的 GET 请求。你可以直接将这段代码作为你项目中的网络层核心参考。