如何配置Web API使其返回模型验证的全部错误而非单个错误？

问题原因 #

该现象通常由两个默认配置限制导致：

• System.Text.Json 输入格式化器默认遇到第一个反序列化错误（如类型不匹配、格式非法）就终止解析，不会处理后续字段
• Mvc 框架默认存在验证错误数量上限，触发阈值后会自动截断剩余错误

修复配置 #

直接修改服务注册代码如下即可：

services.AddControllers()
    // 配置Json反序列化行为，收集所有反序列化错误
    .AddJsonOptions(options =>
    {
        // 允许输出反序列化错误信息
        options.AllowInputFormatterExceptionMessages = true;
        // 可选：放宽Json格式限制，比如允许末尾逗号
        options.JsonSerializerOptions.AllowTrailingCommas = true;
    })
    // 取消验证错误数量限制
    .AddMvcOptions(options =>
    {
        // 可根据业务需要调整为指定数值，int.MaxValue代表不限制
        options.MaxValidationErrors = int.MaxValue;
    })
    .ConfigureApiBehaviorOptions(setupAction =>
    {
        setupAction.InvalidModelStateResponseFactory = context =>
        {
            // 现在context.ModelState已包含全部验证错误，可按需求组装返回格式
            var errorList = context.ModelState
                .Where(item => item.Value.Errors.Any())
                .ToDictionary(
                    key => key.Key,
                    value => value.Value.Errors.Select(e => e.ErrorMessage).ToList()
                );

            return new BadRequestObjectResult(new
            {
                Code = StatusCodes.Status400BadRequest,
                Msg = "参数验证失败",
                Errors = errorList
            });
        };
    });

注意事项 #

如果你项目中使用的是Newtonsoft.Json而非System.Text.Json，需要额外配置Newtonsoft的序列化行为，避免单错误短路：

services.AddControllers()
    .AddNewtonsoftJson(options =>
    {
        options.SerializerSettings.Error = (sender, args) =>
        {
            // 收集错误后跳过当前字段，继续处理后续内容
            args.ErrorContext.Handled = true;
        };
    })
    // 后续其他配置和上述一致

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