C / C++ / 系统课时

设计长度字段消息帧格式

设计长度字段消息帧格式

TCP 只提供连续字节流,不知道一条业务消息在哪里结束。本节设计一种固定长度头部加可变负载的二进制帧,明确长度字段含义、消息类型、网络字节序和异常长度规则,使编码端与解码端能够对同一批字节得到唯一解释。

学习目标

  • 设计包含长度、消息类型和负载的稳定二进制帧格式
  • 正确处理网络字节序以及长度字段的边界检查
  • 使用可运行的 C++ 示例验证编码与解码结果

确定帧布局

一个便于增量解析的最小帧可以由 4 字节长度字段、1 字节消息类型和可变长度负载组成。这里规定长度字段表示它后面的字节数,也就是 type + payload,而不是整个帧的总长度。

长度字段消息帧的字节布局

这种定义有两个直接好处:接收端只要先得到前 4 字节,就能计算完整帧还差多少字节;类型字段固定在长度字段之后,也能在不解析负载内容的情况下完成消息分派。

例如负载为 hello,消息类型占 1 字节,那么长度字段写入 6,整个帧实际占 4 + 6 = 10 字节。

统一字节序和长度规则

多字节整数必须规定统一字节序,否则不同 CPU 架构可能对同一组字节得到不同数值。网络协议通常采用大端序,因此 32 位长度值应按最高有效字节在前的顺序写入。

长度校验也必须在分配大块内存或读取负载之前完成。假设允许的最大负载为 1 MiB,那么合法的 bodyLength 范围是 1 到 1 + 1024 * 1024:最小值 1 用来保证消息类型字段确实存在。

编码并解码一个完整帧

下面的示例不依赖平台的 htonl,而是显式按大端序读写 32 位整数,因此编码规则本身十分清楚。

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

constexpr std::uint32_t kMaxPayload = 1024 * 1024;

void appendUint32BE(std::vector<std::uint8_t>& out, std::uint32_t value) {
    out.push_back(static_cast<std::uint8_t>((value >> 24) & 0xff));
    out.push_back(static_cast<std::uint8_t>((value >> 16) & 0xff));
    out.push_back(static_cast<std::uint8_t>((value >> 8) & 0xff));
    out.push_back(static_cast<std::uint8_t>(value & 0xff));
}

std::uint32_t readUint32BE(const std::uint8_t* p) {
    return (static_cast<std::uint32_t>(p[0]) << 24) |
           (static_cast<std::uint32_t>(p[1]) << 16) |
           (static_cast<std::uint32_t>(p[2]) << 8) |
           static_cast<std::uint32_t>(p[3]);
}

std::vector<std::uint8_t> encode(std::uint8_t type, const std::string& payload) {
    if (payload.size() > kMaxPayload) {
        throw std::length_error("payload too large");
    }

    // 长度字段只描述 type 与 payload,不包含自身的 4 个字节。
    const auto bodyLength = static_cast<std::uint32_t>(1 + payload.size());
    std::vector<std::uint8_t> frame;
    frame.reserve(4 + bodyLength);
    appendUint32BE(frame, bodyLength);
    frame.push_back(type);
    frame.insert(frame.end(), payload.begin(), payload.end());
    return frame;
}

void decodeCompleteFrame(const std::vector<std::uint8_t>& frame) {
    if (frame.size() < 5) {
        throw std::runtime_error("frame too short");
    }

    const std::uint32_t bodyLength = readUint32BE(frame.data());
    if (bodyLength < 1 || bodyLength > 1 + kMaxPayload) {
        throw std::runtime_error("invalid body length");
    }
    if (frame.size() != 4 + bodyLength) {
        throw std::runtime_error("incomplete or extra bytes");
    }

    const std::uint8_t type = frame[4];
    const std::string payload(frame.begin() + 5, frame.end());
    std::cout << "type=" << static_cast<int>(type)
              << " payload=" << payload
              << " bytes=" << frame.size() << '\n';
}

int main() {
    const auto frame = encode(2, "hello");
    decodeCompleteFrame(frame);
}

预期输出:

text
type=2 payload=hello bytes=10

把异常输入定义成协议规则

协议设计不能只说明正常数据长什么样,还要规定错误数据怎么处理。长度小于 1 表示缺少类型字段;长度超过最大限制表示非法帧;完整帧实际字节数与声明长度不一致时,则不能把它当作一条完整消息交给上层。

如果连接上的长度头已经非法,不建议扫描后续字节尝试“重新找一个看起来正常的帧头”。二进制负载中任何 4 个字节都可能碰巧像合法长度,这会让连接进入不可预测状态。更稳定的策略是把非法长度判定为协议错误,记录必要日志并关闭当前连接。

长度字段协议真正需要固定的是一组双方共同遵守的不变量:长度究竟覆盖哪些字段、多字节整数采用什么字节序、允许的最大帧有多大,以及非法输入如何终止处理。只要这些规则没有歧义,后续增量解码器才能安全地从 TCP 字节流中恢复消息边界。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计长度字段消息帧格式

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

登录哪都通