.NET 6 Web API文件上传功能异常崩溃问题排查求助

针对你遇到的.NET 6 Web API文件上传接口崩溃、进程直接终止的问题，常见原因及排查方向如下：

1. 请求大小限制触发进程终止 #

.NET 6默认对请求体大小有严格限制（默认30MB），且未显式配置多部分表单数据的长度限制时，当选择的文件大小接近或超过阈值，会直接终止进程而非返回错误响应。

检查Program.cs中是否配置了请求大小相关参数：

builder.Services.Configure<Microsoft.AspNetCore.Http.Features.FormOptions>(options =>
{
    options.MultipartBodyLengthLimit = 104857600; // 设置为100MB，可根据需求调整
    options.ValueLengthLimit = int.MaxValue;
});

// 同时配置全局请求体大小
builder.WebHost.ConfigureKestrel(options =>
{
    options.Limits.MaxRequestBodySize = 104857600;
});

2. Swagger UI请求格式不兼容 #

你的接口同时包含IFormFile（需从Multipart表单读取）和普通字符串参数（bucketName、prefix），Swagger默认可能将字符串参数解析为Query参数，导致请求格式混合了multipart/form-data和Query参数，部分服务器解析时出现未捕获异常，直接终止进程。

解决方式：显式指定所有参数从FormData读取，修改接口代码：

[HttpPost("upload201")]
public async Task<IActionResult> Upload201FileAsync([FromForm]IFormFile file, [FromForm]string bucketName, [FromForm]string? prefix)
{
    return Ok($"File {prefix}/{file.FileName} uploaded to S3 successfully!");
}

3. 调试器或VS2022环境兼容性问题 #

部分VS2022早期版本与.NET 6调试器存在兼容性问题，处理Multipart请求时会触发未捕获的调试异常，导致进程终止。

排查步骤：

• 将VS2022更新至最新稳定版
• 尝试无调试模式运行（Ctrl+F5），观察是否仍会终止
• 更换浏览器测试Swagger接口（如从Edge切换到Chrome）

4. 未配置全局异常处理 #

如果项目未添加全局异常处理中间件，请求解析过程中出现的未捕获异常（比如Multipart表单解析失败）会直接终止进程，而非返回友好错误响应。

添加全局异常处理中间件验证：

app.UseExceptionHandler(errorApp =>
{
    errorApp.Run(async context =>
    {
        context.Response.StatusCode = StatusCodes.Status500InternalServerError;
        context.Response.ContentType = "application/json";
        var exceptionHandlerPathFeature = context.Features.Get<IExceptionHandlerPathFeature>();
        await context.Response.WriteAsJsonAsync(new { 
            Error = exceptionHandlerPathFeature?.Exception.Message,
            Path = exceptionHandlerPathFeature?.Path
        });
    });
});

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