c++如何将结构体列表序列化为MessagePack二进制流【进阶】-C++-PHP中文网

因为MessagePack默认不识别自定义结构体，需用MSGPACK_DEFINE宏在结构体内显式声明成员序列化顺序，否则msgpack::pack会编译失败；std::vector可直接pack，无需手动循环。

c++如何将结构体列表序列化为messagepack二进制流【进阶】

为什么直接用 `msgpack::pack` 对 `std::vector` 会失败？

因为 MessagePack 默认不识别自定义结构体，msgpack::pack 遇到 MyStruct 会报错：「no matching function for call to ‘pack’」或触发编译期 SFINAE 失败。它只原生支持 int、std::string、std::vector、std::map 等内置/标准类型。结构体必须显式声明序列化协议。

如何为结构体定义 MessagePack 序列化（C++17+ 推荐方式）

使用 MSGPACK_DEFINE 宏，在结构体内声明成员顺序 —— 这是编译期反射，零运行时开销，且兼容 const 成员和私有字段（只要可访问）：

struct Person {
    std::string name;
    int age;
    double salary;
<pre class="brush:php;toolbar:false;">MSGPACK_DEFINE(name, age, salary);

};

注意：MSGPACK_DEFINE 必须写在结构体内部，且参数顺序决定二进制字段顺序；不能漏掉任何需序列化的字段，也不能多写未声明成员。

C++14

C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。

下载

若结构体含 std::optional 或 std::variant，需确保其模板参数也已定义 MSGPACK_DEFINE 或有对应 ADL pack/unpack 函数
含指针、裸数组（如 char buf[32]）、std::unique_ptr 的结构体无法直接序列化，需手动展开或转为 std::vector/std::string
继承体系不被自动支持，基类字段需在派生类 MSGPACK_DEFINE 中显式列出

打包 `std::vector` 到二进制 buffer 的完整流程

核心是两步：先构造 msgpack::sbuffer，再用 msgpack::pack 写入整个 vector —— 不需要循环单个 pack：

std::vector<person> people = {{"Alice", 30, 8500.0}, {"Bob", 25, 6200.0}};
msgpack::sbuffer sbuf;
msgpack::pack(sbuf, people); // ✅ 正确：vector 自动递归 pack 其元素
<p>// 得到二进制流
const char* data = sbuf.data();
size_t size = sbuf.size();</p></person>

不要用 msgpack::pack(sbuf, &people[0], people.size()) —— 这是 C 风格误用，会把 vector 当作裸内存块处理，结果不可预测
若需紧凑输出（省略 map key 字符串长度前缀等），改用 msgpack::sbuffer + msgpack::packer 手动控制，但日常场景没必要
大列表（>10MB）建议预估容量调用 sbuf.reserve(n)，避免多次 realloc

反序列化时常见崩溃点与防御写法

最常踩的坑是字段名/顺序不一致导致 msgpack::type_error 或内存越界读 —— 比如结构体加了字段但旧数据没更新，或网络收包截断：

try {
    msgpack::object_handle oh = msgpack::unpack(data, size);
    std::vector<person> loaded = oh.get().as<:vector>>();
} catch (const msgpack::type_error& e) {
    // e.what() 可能是 "convert error" 或 "type mismatch"
    // 建议记录原始二进制前 32 字节用于调试
}</:vector></person>