C / C++ / 系统课时
定义 RPC 请求响应模型
定义 RPC 请求响应模型
把普通消息协议升级为 RPC,第一步不是加入网络调用封装,而是定义一组能够完整描述“调用谁、调用什么、哪次调用、携带什么数据以及结果如何”的请求响应模型。
学习目标
- 设计 RPC 请求与响应最小字段集合
- 理解请求 ID 在并发调用和响应匹配中的作用
- 明确协议层字段与业务负载之间的边界
请求模型要描述一次完整调用
一个最小 RPC 请求至少需要服务名、方法名、请求 ID 和负载。服务名决定目标服务,方法名决定调用入口,请求 ID 用于把响应关联回原始请求,负载则保存方法参数编码后的字节。
这些字段应属于 RPC 协议层,而不是混入业务对象。业务参数可以使用 Protobuf、JSON 或自定义二进制格式编码,但 RPC 框架只负责把这段负载作为字节序列传输。
响应模型至少需要请求 ID、状态码、状态说明和返回负载。请求 ID 必须原样返回,这样一个 TCP 连接上同时存在多次调用时,客户端才能正确完成对应的 Future、Promise 或回调。

用 C++ 定义最小数据结构
下面的示例只定义 RPC 语义模型,不绑定具体序列化库。payload 使用字节数组表示,使 RPC 层不会依赖某一种业务编码方式。
#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';
}预期输出:
route=UserService.GetUser
requestId=42
status=0 OK这个模型已经具备序列化所需的全部核心信息。真正接入网络时,只需要让编解码层把这些字段编码成协议帧,再在另一端恢复成相同结构。
请求 ID 解决并发响应匹配
如果一个连接每次只能发送一个请求,然后阻塞等待响应,请求 ID 看起来似乎多余。但高性能 RPC 通常允许多个请求同时在途,而且服务端的处理耗时不同,响应返回顺序不一定与请求发送顺序一致。
客户端因此需要维护类似 requestId -> pending call 的映射。发送前注册等待项,收到响应后按请求 ID 查找并完成对应调用,再删除映射。请求超时或连接关闭时,也必须清理尚未完成的等待项。
状态字段不要塞进业务负载
调用成功与失败属于 RPC 框架语义,应由 statusCode 和 statusMessage 表达。业务返回值属于方法语义,应放进 payload。这两个层次分开后,框架才能统一处理“方法不存在”“服务不存在”“解码失败”“服务端内部错误”等失败,而不必理解具体业务对象。
状态码还应保持稳定。例如 0 表示成功,非零值表示协议定义的错误类别。不要直接把不同平台的异常字符串当作唯一错误协议,因为文本既不稳定,也不利于客户端按类型处理。
一个可扩展的 RPC 模型不需要一开始就塞入几十个字段。先固定服务名、方法名、请求 ID、负载和状态信息,再让超时、追踪 ID、元数据、鉴权信息等能力通过后续版本演进,协议会更容易保持兼容。