.NET Core API如何自定义List参数绑定失败的BadRequest提示信息

方案一：通过ApiBehaviorOptions统一修改模型绑定错误响应 #

模型绑定失败的错误由框架自动返回，可通过配置ApiBehaviorOptions替换默认错误信息，步骤如下：

1. 在.NET 6+的Program.cs或旧版本的Startup.cs的ConfigureServices方法中添加配置：

builder.Services.Configure<ApiBehaviorOptions>(options =>
{
    options.InvalidModelStateResponseFactory = context =>
    {
        // 检测是否为List类型转换错误
        var isListConvertError = context.ModelState.Values.Any(v => 
            v.Errors.Any(e => e.ErrorMessage.Contains("could not be converted to System.Collections.Generic.List`1")));
        
        if (isListConvertError)
        {
            return new BadRequestObjectResult(new { message = "JSON格式不正确" });
        }
        
        // 其他模型绑定错误可自定义提示
        return new BadRequestObjectResult(new { message = "请求参数格式错误" });
    };
});

此配置会拦截所有模型绑定失败的请求，根据错误特征返回友好提示，避免暴露内部类名等敏感信息。

方案二：自定义中间件捕获JSON序列化错误 #

若需要更早拦截JSON解析错误（早于模型绑定阶段），可编写自定义中间件处理：

1. 创建中间件类：

public class JsonErrorHandlingMiddleware
{
    private readonly RequestDelegate _next;

    public JsonErrorHandlingMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    public async Task InvokeAsync(HttpContext context)
    {
        try
        {
            await _next(context);
        }
        catch (System.Text.Json.JsonException ex)
        {
            if (ex.Message.Contains("could not be converted to System.Collections.Generic.List`1"))
            {
                context.Response.StatusCode = StatusCodes.Status400BadRequest;
                context.Response.ContentType = "application/json";
                await context.Response.WriteAsync(System.Text.Json.JsonSerializer.Serialize(new { message = "JSON格式不正确" }));
            }
            else
            {
                context.Response.StatusCode = StatusCodes.Status400BadRequest;
                context.Response.ContentType = "application/json";
                await context.Response.WriteAsync(System.Text.Json.JsonSerializer.Serialize(new { message = "请求JSON格式错误" }));
            }
        }
    }
}

2. 在Program.cs中注册中间件（需放在app.UseRouting()之前）：

app.UseMiddleware<JsonErrorHandlingMiddleware>();

该中间件可捕获JSON序列化时抛出的JsonException，直接返回自定义友好提示，完全替代框架默认错误信息。

关键说明 #

• 模型绑定错误发生在Action方法执行前，因此Action内部的try/catch无法捕获此类错误，必须通过全局配置或中间件处理。
• 可根据需求调整错误判断条件，比如直接统一返回通用格式错误提示，无需区分具体错误类型。

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