Web API中JSON反序列化Enum拼写错误时，如何实现请求全成功或全失败？

我定义了如下Person类：

public class Person 
{ 
    [JsonConstructor] 
    public Person(string name, DayOfWeek bornOnDay) => (Name, BornOnDay) = (name, bornOnDay); 
    public string Name { get; protected set; } 
    public DayOfWeek BornOnDay { get; protected set; } 
}

并实现了一个接收List<Person>的POST端点：

[HttpPost] 
[Route("api/people")] 
public IHttpActionResult PostPerson([FromBody]List<Person> people) 
{ 
    // 业务逻辑
}

现在发现当请求体中有枚举拼写错误时（比如把Monday写成Moonday），系统不会抛出错误，只会跳过反序列化失败的对象，只保留正确的对象。我希望这个POST操作要么完全成功，要么彻底失败，返回400状态码，而不是部分成功。有没有不需要把枚举类型改成string再手动用Enum.TryParse的实现方法？

你遇到的问题是因为Json.NET（ASP.NET Web API默认的JSON序列化库）在反序列化集合时，默认会忽略单个元素的反序列化错误，继续处理下一个元素。要实现"全成功或全失败"的效果，只需要调整全局的JSON序列化配置，让它遇到错误时直接抛出异常，而不是跳过错误元素。

步骤1：全局配置Json.NET设置 #

在WebApiConfig.cs的Register方法中添加以下配置：

public static class WebApiConfig
{
    public static void Register(HttpConfiguration config)
    {
        // 获取JSON格式化器的序列化设置
        var jsonSettings = config.Formatters.JsonFormatter.SerializerSettings;
        
        // 添加StringEnumConverter，确保枚举以字符串形式反序列化
        jsonSettings.Converters.Add(new StringEnumConverter());
        
        // 修改错误处理逻辑：遇到反序列化错误时不忽略，抛出异常
        jsonSettings.Error = (sender, args) =>
        {
            // 不标记错误为已处理，让异常向上传递
            args.ErrorContext.Handled = false;
        };
        
        // 其他Web API路由配置...
        config.MapHttpAttributeRoutes();
        config.Routes.MapHttpRoute(
            name: "DefaultApi",
            routeTemplate: "api/{controller}/{id}",
            defaults: new { id = RouteParameter.Optional }
        );
    }
}

为什么这个方案有效？ #

1. StringEnumConverter：确保枚举值以字符串形式进行反序列化，当遇到无法匹配的字符串（比如Moonday）时，会触发JsonSerializationException。
2. 错误处理事件：通过将args.ErrorContext.Handled设为false，阻止Json.NET忽略错误并继续处理集合中的下一个元素。这样一旦有任何一个元素反序列化失败，整个反序列化过程就会终止，Web API框架会自动捕获这个异常，返回400 Bad Request状态码给客户端。

额外说明 #

• 这个方案不需要修改Person类的任何代码，也不需要手动处理枚举的解析逻辑，完全依赖序列化库的配置实现。
• 如果你的项目是ASP.NET Core（而非传统ASP.NET Web API），配置方式会略有不同，但核心思路一致：修改JSON序列化器的错误处理行为，禁止忽略反序列化错误。

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