使用MessagePack 3.1.4序列化/反序列化时如何保持对象引用一致性

云原生阿岚

2026-4-7

嘿，刚好对MessagePack的引用处理这块熟得很，你的问题我来给你掰扯清楚～

首先得说透：MessagePack默认是不跟踪对象引用的，所以同一个对象的多个引用会被重复序列化，反序列化后就变成好几个独立的实例，这就是你现在遇到的问题。要解决这个，核心就是让MessagePack在序列化时记录对象的引用关系，反序列化时精准重建这些引用。

针对你用的3.1.4版本，直接用内置的引用保留配置就行，不用搞复杂的自定义解析器。具体操作如下：

先创建一个带引用保留的全局序列化配置，避免每次序列化都重复创建：

private static readonly MessagePackSerializerOptions _referencePreserveOptions = MessagePackSerializerOptions.Standard
    .WithReferenceHandling(ReferenceHandling.Preserve);

如果你是用无契约的序列化（也就是不想给每个字段/属性加[Key]标记），就把Standard换成ContractlessStandard：

private static readonly MessagePackSerializerOptions _contractlessReferenceOptions = MessagePackSerializerOptions.ContractlessStandard
    .WithReferenceHandling(ReferenceHandling.Preserve);

修改你原来的序列化、反序列化方法，把这个配置传进去：

public static byte[] Serialize<T>(T source)
{
    using (var stream = new MemoryStream())
    {
        MessagePackSerializer.Serialize(stream, source, _referencePreserveOptions);
        return stream.ToArray();
    }
}

public static T Deserialize<T>(byte[] source)
{
    using (var stream = new MemoryStream(source))
    {
        return MessagePackSerializer.Deserialize<T>(stream, _referencePreserveOptions);
    }
}

这样配置后，MessagePack会在序列化时给每个首次出现的对象分配唯一ID，后续遇到同一个对象的引用时，只会序列化这个ID而非整个对象内容；反序列化时，会根据ID把所有引用指向同一个实例，完美还原原有的引用关系。

给你举个实际场景验证下：

// 假设你有个自定义业务类
public class UserInfo
{
    [Key(0)]
    public int UserId { get; set; }
    [Key(1)]
    public string UserName { get; set; }
}

// 创建一个对象，让两个引用指向它
var originalUser = new UserInfo { UserId = 456, UserName = "Jack" };
var dataWrapper = new { PrimaryUser = originalUser, BackupUser = originalUser };

// 序列化
var bytes = Serialize(dataWrapper);
// 反序列化
var deserialized = Deserialize<dynamic>(bytes);

// 现在这两个引用是同一个实例，引用相等
Console.WriteLine(ReferenceEquals(deserialized.PrimaryUser, deserialized.BackupUser)); // 输出True

另外要提一句，这个配置还能自动处理循环引用的情况——比如对象A引用对象B，对象B又引用对象A，也不会出现序列化栈溢出的问题，相当省心。

亲测这个方法在3.1.4版本下完全有效，我之前处理过类似的复杂对象引用场景，用这个配置就完美解决了～

内容来源于stack exchange