C / C++ / 系统课时

定义 RPC 请求响应模型

定义 RPC 请求响应模型

把普通消息协议升级为 RPC,第一步不是加入网络调用封装,而是定义一组能够完整描述“调用谁、调用什么、哪次调用、携带什么数据以及结果如何”的请求响应模型。

学习目标

  • 设计 RPC 请求与响应最小字段集合
  • 理解请求 ID 在并发调用和响应匹配中的作用
  • 明确协议层字段与业务负载之间的边界

请求模型要描述一次完整调用

一个最小 RPC 请求至少需要服务名、方法名、请求 ID 和负载。服务名决定目标服务,方法名决定调用入口,请求 ID 用于把响应关联回原始请求,负载则保存方法参数编码后的字节。

这些字段应属于 RPC 协议层,而不是混入业务对象。业务参数可以使用 Protobuf、JSON 或自定义二进制格式编码,但 RPC 框架只负责把这段负载作为字节序列传输。

响应模型至少需要请求 ID、状态码、状态说明和返回负载。请求 ID 必须原样返回,这样一个 TCP 连接上同时存在多次调用时,客户端才能正确完成对应的 Future、Promise 或回调。

RPC 请求响应模型与匹配关系

用 C++ 定义最小数据结构

下面的示例只定义 RPC 语义模型,不绑定具体序列化库。payload 使用字节数组表示,使 RPC 层不会依赖某一种业务编码方式。

cpp
#include <cstdint>
#include <iostream>
#include <string>
#include <vector>

struct RpcRequest {
    std::string service;
    std::string method;
    std::uint64_t requestId{};
    std::vector<std::uint8_t> payload;
};

struct RpcResponse {
    std::uint64_t requestId{};
    std::int32_t statusCode{};
    std::string statusMessage;
    std::vector<std::uint8_t> payload;
};

bool validateRequest(const RpcRequest& request, std::string& reason) {
    // 路由字段不能为空,否则服务端无法找到实际处理器。
    if (request.service.empty() || request.method.empty()) {
        reason = "service or method is empty";
        return false;
    }

    // 约定 0 不作为正常请求 ID,便于识别未初始化数据。
    if (request.requestId == 0) {
        reason = "requestId must be non-zero";
        return false;
    }

    return true;
}

int main() {
    RpcRequest request{
        "UserService",
        "GetUser",
        42,
        {0x10, 0x20, 0x30}
    };

    std::string reason;
    if (!validateRequest(request, reason)) {
        std::cout << "invalid request: " << reason << '\n';
        return 1;
    }

    RpcResponse response{
        request.requestId,
        0,
        "OK",
        {0x7B, 0x7D}
    };

    std::cout << "route=" << request.service << "." << request.method << '\n';
    std::cout << "requestId=" << response.requestId << '\n';
    std::cout << "status=" << response.statusCode << " " << response.statusMessage << '\n';
}

预期输出:

text
route=UserService.GetUser
requestId=42
status=0 OK

这个模型已经具备序列化所需的全部核心信息。真正接入网络时,只需要让编解码层把这些字段编码成协议帧,再在另一端恢复成相同结构。

请求 ID 解决并发响应匹配

如果一个连接每次只能发送一个请求,然后阻塞等待响应,请求 ID 看起来似乎多余。但高性能 RPC 通常允许多个请求同时在途,而且服务端的处理耗时不同,响应返回顺序不一定与请求发送顺序一致。

客户端因此需要维护类似 requestId -> pending call 的映射。发送前注册等待项,收到响应后按请求 ID 查找并完成对应调用,再删除映射。请求超时或连接关闭时,也必须清理尚未完成的等待项。

状态字段不要塞进业务负载

调用成功与失败属于 RPC 框架语义,应由 statusCode 和 statusMessage 表达。业务返回值属于方法语义,应放进 payload。这两个层次分开后,框架才能统一处理“方法不存在”“服务不存在”“解码失败”“服务端内部错误”等失败,而不必理解具体业务对象。

状态码还应保持稳定。例如 0 表示成功,非零值表示协议定义的错误类别。不要直接把不同平台的异常字符串当作唯一错误协议,因为文本既不稳定,也不利于客户端按类型处理。

一个可扩展的 RPC 模型不需要一开始就塞入几十个字段。先固定服务名、方法名、请求 ID、负载和状态信息,再让超时、追踪 ID、元数据、鉴权信息等能力通过后续版本演进,协议会更容易保持兼容。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

定义 RPC 请求响应模型

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通