.NET 4.8中PopulateObject反序列化枚举遇新增值崩溃，求通用解决办法

当第三方API新增未在本地枚举中定义的值时，Newtonsoft.Json反序列化会抛出如下错误：

Error converting value 'x' to 'enum-y'

原有方案为每个枚举编写专属转换器并添加Unknown成员，但面对大量枚举时过于繁琐。以下是无需重复编写转换器的通用解决方法：

通用转换器实现 #

编写一个继承自StringEnumConverter的通用转换器，动态处理所有枚举类型的反序列化，自动将未匹配的值映射到枚举的Unknown成员：

public class FallbackUnknownEnumConverter : StringEnumConverter
{
    public override object ReadJson(JsonReader reader, Type objectType, object existingValue, JsonSerializer serializer)
    {
        // 处理可空枚举，获取实际枚举类型
        Type enumType = Nullable.GetUnderlyingType(objectType) ?? objectType;
        if (!enumType.IsEnum)
        {
            return base.ReadJson(reader, objectType, existingValue, serializer);
        }

        if (reader.TokenType == JsonToken.String)
        {
            string enumValueStr = reader.Value.ToString();
            // 尝试解析枚举值
            if (Enum.TryParse(enumType, enumValueStr, out object parsedResult))
            {
                return parsedResult;
            }
            // 解析失败时返回Unknown成员
            FieldInfo unknownMember = enumType.GetField("Unknown");
            if (unknownMember != null)
            {
                return unknownMember.GetValue(null);
            }
            // 无Unknown成员时抛出明确异常，可根据需求调整为返回默认值
            throw new JsonSerializationException($"无法将值 '{enumValueStr}' 转换为枚举 '{enumType.Name}'，该枚举未定义Unknown成员");
        }

        return base.ReadJson(reader, objectType, existingValue, serializer);
    }
}

使用方式 #

方式1：全局注册（推荐） #

在应用启动时配置JsonSerializerSettings，一次性对所有枚举生效，无需逐个添加特性：

// 初始化全局序列化配置
var jsonSettings = new JsonSerializerSettings();
jsonSettings.Converters.Add(new FallbackUnknownEnumConverter());

// 使用配置好的settings进行反序列化
JsonConvert.PopulateObject(response.Content, userSettings, jsonSettings);

方式2：单个枚举特性标记 #

如果仅需对部分枚举生效，可直接在枚举上添加特性：

[JsonConverter(typeof(FallbackUnknownEnumConverter))]
public enum Method
{
    Unknown,
    Method1,
    Method2
}

注意事项 #

• 确保所有需要兼容未知值的枚举都定义了Unknown成员，否则转换器会抛出异常（可修改代码改为返回枚举默认值）
• 如需忽略大小写解析，可将Enum.TryParse的第三个参数设为true
• 自动支持可空枚举类型（如Method?）

内容的提问来源于stack exchange，提问作者Marcel Grüger