Minimal API自定义模型绑定下MultipartBodyLengthLimit最优处理方案

你当前的方案虽然能解决问题，但确实存在耦合度高、依赖异常消息判断、需处理可空类型等缺点，并非最优解。以下是更优雅的替代方案，能解决你提到的所有顾虑：

1. 定义自定义异常，明确异常类型 #

首先创建一个专门用于表示文件大小超限的自定义异常，避免依赖InvalidDataException的模糊判断：

public class MultipartLengthExceededException : Exception
{
    public string InputId { get; }
    public long MaxAllowedSize { get; }

    public MultipartLengthExceededException(string inputId, long maxAllowedSize)
        : base($"上传文件大小超过限制：{maxAllowedSize} 字节")
    {
        InputId = inputId;
        MaxAllowedSize = maxAllowedSize;
    }
}

2. 优化自定义模型绑定的异常处理 #

在ApiPayload的BindAsync方法中，捕获InvalidDataException后，通过固定异常特征判断是否为大小超限（ASP.NET Core中该场景的异常消息以Multipart body length limit开头，可提取为常量避免硬编码），然后抛出自定义异常：

public static class ApiPayloadBinder
{
    private const string MultipartLimitMessagePrefix = "Multipart body length limit";

    public static async ValueTask<ApiPayload> BindAsync(HttpContext context, ParameterInfo parameter)
    {
        try
        {
            var form = await context.Request.ReadFormAsync();
            
            // 读取必填元数据（包括input id）
            var inputId = form["inputId"].FirstOrDefault() ?? throw new InvalidDataException("缺少必填的input id");
            // 其他元数据和文件读取逻辑...

            return new ApiPayload
            {
                InputId = inputId,
                // 赋值其他属性
            };
        }
        catch (InvalidDataException ex)
        {
            // 判断是否为文件大小超限异常
            if (ex.Message.StartsWith(MultipartLimitMessagePrefix))
            {
                // 尝试从请求中获取input id（若表单未完全读取，可从查询参数或请求头传递，根据业务调整）
                var inputId = context.Request.Query["inputId"].FirstOrDefault() ?? context.Request.Headers["X-Input-Id"].FirstOrDefault() ?? "unknown";
                var maxSize = context.Features.Get<IHttpRequestBodySizeFeature>()?.MaxRequestBodySize ?? 0;
                throw new MultipartLengthExceededException(inputId, maxSize);
            }
            // 其他绑定异常直接抛出
            throw;
        }
    }
}

3. 用端点过滤器捕获自定义异常 #

创建一个通用的端点过滤器，专门捕获MultipartLengthExceededException并返回自定义响应：

public class MultipartExceptionFilter : IEndpointFilter
{
    public async ValueTask<object?> InvokeAsync(EndpointFilterInvocationContext context, EndpointFilterDelegate next)
    {
        try
        {
            return await next(context);
        }
        catch (MultipartLengthExceededException ex)
        {
            return Results.BadRequest(new
            {
                message = ex.Message,
                inputId = ex.InputId
            });
        }
    }
}

然后在使用ApiPayload的端点上添加该过滤器：

app.MapPost("/upload", (ApiPayload payload) => 
{
    // 正常业务逻辑
    return Results.Ok();
})
.AddEndpointFilter<MultipartExceptionFilter>();

该方案的优势 #

• 解耦模型绑定与过滤器：模型绑定仅负责转换异常类型，过滤器专注于异常响应处理，无需通过context.Items通信
• 避免模糊的异常判断：通过自定义异常明确区分文件大小超限场景，不再依赖InvalidDataException的消息
• 无需处理可空类型：模型绑定成功时返回正常实例，失败时直接抛异常，无需将ApiPayload设为可空
• 扩展性强：过滤器可复用在所有需要处理文件上传超限的端点，若需要全局处理，可改为全局异常中间件

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