MessagePack字符串反序列化为枚举的问题及C#端解决方案咨询

针对你遇到的Java端以字符串发送枚举、C#端需反序列化为Enum类型（包括List<Enum>集合）的问题，提供以下两种可靠解决方案：

方案1：自定义集合格式化器 #

针对枚举列表字段单独配置格式化器，逻辑和单个枚举的格式化器一致，扩展为集合处理：

public class EnumListAsStringFormatter<TEnum> : IMessagePackFormatter<List<TEnum>> 
    where TEnum : struct, Enum
{
    public void Serialize(ref MessagePackWriter writer, List<TEnum> value, MessagePackSerializerOptions options)
    {
        writer.WriteArrayHeader(value.Count);
        foreach (var enumVal in value)
        {
            writer.Write(enumVal.ToString());
        }
    }

    public List<TEnum> Deserialize(ref MessagePackReader reader, MessagePackSerializerOptions options)
    {
        var count = reader.ReadArrayHeader();
        var enumList = new List<TEnum>(count);
        
        for (int i = 0; i < count; i++)
        {
            var enumStr = reader.ReadString();
            if (!Enum.TryParse(enumStr, out TEnum result))
            {
                // 根据业务需求处理解析失败场景：抛异常/设默认值/忽略
                throw new MessagePackSerializationException($"无法解析字符串\"{enumStr}\"为枚举{typeof(TEnum).Name}");
            }
            enumList.Add(result);
        }
        return enumList;
    }
}

使用时直接在枚举列表字段上标注属性：

public class BusinessData
{
    [MessagePackFormatter(typeof(EnumListAsStringFormatter<MyEnum>))]
    public List<MyEnum> StatusList { get; set; }
}

方案2：全局配置枚举处理规则 #

如果希望所有枚举（包括集合中的枚举）都默认按字符串序列化/反序列化，无需逐个字段标注，可以自定义全局解析器：

public class EnumAsStringResolver : IFormatterResolver
{
    public static readonly EnumAsStringResolver Instance = new();
    private EnumAsStringResolver() { }

    public IMessagePackFormatter<T>? GetFormatter<T>()
    {
        return FormatterCache<T>.Formatter;
    }

    private static class FormatterCache<T>
    {
        public static readonly IMessagePackFormatter<T>? Formatter = 
            (IMessagePackFormatter<T>?)GetFormatter(typeof(T));
    }

    private static object? GetFormatter(Type type)
    {
        // 处理单个枚举类型
        if (type.IsEnum)
        {
            var formatterType = typeof(EnumAsStringFormatter<>).MakeGenericType(type);
            return Activator.CreateInstance(formatterType);
        }
        // 处理List<枚举>类型
        if (type.IsGenericType && type.GetGenericTypeDefinition() == typeof(List<>))
        {
            var enumType = type.GetGenericArguments()[0];
            if (enumType.IsEnum)
            {
                var formatterType = typeof(EnumListAsStringFormatter<>).MakeGenericType(enumType);
                return Activator.CreateInstance(formatterType);
            }
        }
        return null;
    }
}

配置全局序列化选项：

var globalOptions = MessagePackSerializerOptions.Standard
    .WithFormatterResolver(new CompositeResolver(
        EnumAsStringResolver.Instance,
        StandardResolver.Instance));

// 反序列化时使用该配置
var data = MessagePackSerializer.Deserialize<BusinessData>(receivedBytes, globalOptions);

关键注意事项 #

• 确保Java端枚举的toString()输出与C#端枚举的名称完全一致（MessagePack默认大小写敏感，需避免大小写不匹配问题）
• 解析失败的逻辑需结合业务场景调整：比如允许无效项时，可跳过或添加默认枚举值
• 全局配置会影响所有枚举类型，若存在部分枚举需按数值序列化的场景，需单独为该枚举字段指定格式化器覆盖全局规则

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