将C++ Boost序列化封装为Boost.Python模块后序列化格式变化问题

核心原因：两端归档对象的初始化配置不匹配 #

Boost.Serialization的文本归档签名（如22 serialization::archive 17）由归档对象的构造参数决定，同时C++端的重复签名源于代码逻辑问题，具体拆解如下：

1. C++端两次签名的成因 #

C++生成的归档出现两次签名，通常是以下两种情况：

• 嵌套归档操作：你的C++代码中可能在序列化某个对象时，该对象的serialize函数内部又创建了一个text_oarchive并写入同一个输出流，导致两次签名被重复写入。
• 多次创建归档对象：代码中不小心对同一个输出流初始化了多个text_oarchive实例，每个实例都会默认写入一次签名。

2. Python封装模块无签名的成因 #

Python调用封装模块生成的归档没有签名，几乎可以确定是封装时的C++代码禁用了归档头签名：
在C++中创建文本归档时，如果使用了boost::archive::no_header标志，就会跳过签名写入，比如：

// 禁用签名的写法
std::ofstream ofs("archive.txt");
boost::archive::text_oarchive oa(ofs, boost::archive::no_header);
oa << my_object;

而默认的构造方式（不带第二个参数）会自动写入签名：

// 默认带签名的写法
std::ofstream ofs("archive.txt");
boost::archive::text_oarchive oa(ofs);
oa << my_object;

如果你的Python绑定代码用了第一种写法，自然不会生成签名，和C++端的带签名（甚至双签名）归档就会不兼容，触发input stream error。

解决方向 #

• 修正C++端的重复签名问题：检查C++序列化代码，确保整个输出流只被一个text_oarchive实例处理，避免嵌套归档或重复创建归档对象。
• 统一两端的归档配置：要么让Python封装的代码去掉no_header标志，和C端一样默认写入签名；要么让C端也添加no_header标志，两端都禁用签名。必须保证两端的归档配置完全一致。
• 验证归档格式：修正后可以直接查看生成的归档文件，确认签名数量和存在状态一致，再进行跨进程序列化测试。

内容的提问来源于stack exchange，提问作者may1212