MessagePack-CSharp 中处理字符串反序列化的 FormatterNotRegisteredException 异常

在使用 MessagePack-CSharp 进行数据序列化/反序列化时，开发者可能会遇到一个常见异常：FormatterNotRegisteredException: 'System.String is not registered in resolver'。这个异常通常出现在使用自定义解析器（Resolver）时，特别是当开发者只使用了生成的解析器而没有正确组合内置解析器的情况下。

异常原因分析

MessagePack-CSharp 的解析器系统采用模块化设计，不同类型的格式化器（Formatter）被分配到不同的解析器中。对于基础类型如字符串（System.String），其格式化器默认位于 BuiltinResolver 中。当开发者创建自定义解析器时，如果仅使用生成的解析器而没有包含内置解析器，就会导致基础类型的格式化器缺失。

解决方案

正确的做法是使用 CompositeResolver 来组合多个解析器。CompositeResolver 允许将多个解析器合并为一个，确保所有需要的格式化器都能被找到。以下是推荐的解决方案：

1. 确保包含 BuiltinResolver 以处理基础类型
2. 包含生成的解析器以处理自定义类型
3. 根据需要添加其他标准解析器

实际应用示例

对于文章开头描述的场景，正确的实现方式应该是：

[GeneratedMessagePackResolver]
internal partial class MessagepackBouncyHsmResolver
{
    public static readonly IFormatterResolver Instance = MessagePack.Resolvers.CompositeResolver.Create(
        MessagePack.Resolvers.BuiltinResolver.Instance,
        MessagepackBouncyHsmResolver.Instance,
        MessagePack.Resolvers.StandardResolver.Instance
    );
}

最佳实践建议

1. 对于大多数应用场景，建议始终使用 CompositeResolver 来组合解析器
2. 明确列出所有需要的解析器，包括：
   • BuiltinResolver（基础类型）
   • 生成的解析器（自定义类型）
   • StandardResolver（标准类型）
3. 在性能敏感场景，可以优化解析器组合，只包含实际需要的解析器
4. 考虑将组合后的解析器缓存为静态实例以提高性能

深入理解

MessagePack-CSharp 的解析器系统设计遵循了单一职责原则，每个解析器只负责特定类型的格式化。这种设计带来了以下优势：

1. 模块化：可以灵活组合不同的解析器
2. 可扩展性：可以轻松添加新的解析器
3. 性能优化：可以精确控制加载哪些格式化器

理解这一设计理念有助于开发者更好地使用和扩展 MessagePack-CSharp 的功能。

总结

处理 MessagePack-CSharp 中的 FormatterNotRegisteredException 异常，关键在于正确组合解析器。通过使用 CompositeResolver 并包含必要的内置解析器，可以确保所有类型都能被正确序列化和反序列化。这一解决方案不仅适用于字符串类型，也同样适用于其他基础类型和自定义类型。