Kestrel MaxRequestBodySize超限时多文件上传异常咨询

我之前也碰到过一模一样的情况，这其实是Kestrel的请求截断逻辑和浏览器自动重试机制撞在一起导致的问题，咱们一步步拆解原因和解决方案：

问题根源 #

当上传的多文件总大小超过MaxRequestBodySize时，Kestrel会在请求还没完全接收完毕时就直接中断连接——这时候浏览器检测到连接异常，会默认触发自动重试，就导致你的控制器动作被多次调用，而且因为每次请求截断的时机不确定，重试次数看起来毫无规律。而你预期的BadHttpRequestException，其实可能在Kestrel层面就已经中断了请求，根本没传递到控制器动作里。

解决方案 #

1. 正确配置请求大小限制并捕获异常 #

首先要确保你正确设置了请求大小限制，同时通过中间件捕获Kestrel抛出的请求大小异常，返回明确的错误响应，从根源上避免浏览器重试：

全局配置Kestrel请求大小

在Program.cs里调整Kestrel的全局限制：

var builder = WebApplication.CreateBuilder(args);

// 配置Kestrel的最大请求体大小（示例为10MB）
builder.WebHost.ConfigureKestrel(serverOptions =>
{
    serverOptions.Limits.MaxRequestBodySize = 10 * 1024 * 1024;
});

// 也可以在控制器全局配置里设置
builder.Services.AddControllers(options =>
{
    options.MaxRequestBodySize = 10 * 1024 * 1024;
});

局部覆盖（针对特定上传动作）

如果只有某个上传接口需要特殊限制，可以用属性直接标注：

[HttpPost("batch-upload")]
[RequestSizeLimit(20 * 1024 * 1024)] // 单独设置为20MB
public async Task<IActionResult> BatchUploadFiles()
{
    // 你的文件处理逻辑
}

中间件捕获请求大小异常

添加一个全局异常处理中间件，专门捕获BadHttpRequestException并返回标准413状态码：

var app = builder.Build();

app.Use(async (context, next) =>
{
    try
    {
        await next();
    }
    catch (BadHttpRequestException ex) when (ex.StatusCode == StatusCodes.Status413PayloadTooLarge)
    {
        context.Response.StatusCode = StatusCodes.Status413PayloadTooLarge;
        await context.Response.WriteAsync("上传文件总大小超出限制，请调整后重试");
    }
});

app.MapControllers();
app.Run();

2. 前端禁用自动重试 #

即使后端返回了413，部分浏览器还是会默认重试，所以可以在前端上传逻辑里主动禁用重试：
比如用Fetch API实现：

async function uploadFiles(files) {
    const formData = new FormData();
    files.forEach(file => formData.append('files', file));

    try {
        const response = await fetch('/api/batch-upload', {
            method: 'POST',
            body: formData,
            keepalive: false, // 禁用keepalive避免自动重试
            signal: new AbortController().signal // 可选：支持手动中断请求
        });

        if (!response.ok) {
            throw new Error(await response.text());
        }
        alert('上传成功');
    } catch (error) {
        console.error('上传失败:', error);
        alert(error.message);
        // 这里不要重新发起请求
    }
}

3. 控制器内验证请求完整性 #

在控制器动作里，你可以额外检查请求是否被中断，避免处理不完整的请求：

[HttpPost("batch-upload")]
public async Task<IActionResult> BatchUploadFiles(CancellationToken cancellationToken)
{
    // 提前检查请求是否已被Kestrel中断
    if (cancellationToken.IsCancellationRequested)
    {
        return StatusCode(StatusCodes.Status413PayloadTooLarge, "上传被中断（文件总大小超出限制）");
    }

    try
    {
        var files = Request.Form.Files;
        // 处理文件逻辑
        return Ok("上传成功");
    }
    catch (BadHttpRequestException ex)
    {
        return StatusCode(StatusCodes.Status413PayloadTooLarge, ex.Message);
    }
}

这样调整后，就能避免控制器动作被多次触发，同时正确返回文件过大的错误提示，浏览器也不会再自动重试了。

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