何处调用HttpContext.Request.GetBufferlessInputStream？解决2GB+文件上传问题

这个问题我之前也碰到过！你遇到的错误本质是：ASP.NET会在你访问Request.Form、Request.Files或者默认的Request.InputStream时自动开始缓冲整个请求内容，这时候再调用GetBufferlessInputStream就会触发报错——因为缓冲已经启动了，没法再切换到无缓冲模式。

核心原则就是：必须在任何触发请求缓冲的操作之前调用GetBufferlessInputStream(true)，下面给你几个可行的实现方式：

方案1：控制器动作的最开头（最简单直接） #

如果只是单个上传接口需要支持大文件，直接在控制器动作的第一行调用这个方法，并且确保你的动作方法里没有任何会触发缓冲的参数（比如[FromForm]绑定的模型、IFormFile参数——这些都会自动读取Request.Form/Files）。

示例代码：

[HttpPost]
public async Task<IActionResult> LargeFileUpload()
{
    // 重点：这行必须放在最开头，不能碰任何Request.Form/Files相关的内容
    using var bufferlessStream = HttpContext.Request.GetBufferlessInputStream(true);
    
    // 接下来直接处理这个无缓冲流，比如写入本地文件
    var savePath = Path.Combine(Environment.ContentRootPath, "LargeUploads", Guid.NewGuid().ToString());
    using var fileStream = new FileStream(savePath, FileMode.Create);
    await bufferlessStream.CopyToAsync(fileStream);
    
    return Ok(new { message = "大文件上传完成", filePath = savePath });
}

方案2：用中间件/HttpModule提前拦截（适合全局复用） #

如果多个接口都需要支持大文件上传，或者想把逻辑抽离出来，可以在请求处理的更早阶段（中间件/HttpModule）获取无缓冲流：

ASP.NET Core 用中间件 #

// 在Program.cs里注册中间件，放在路由之前
app.Use(async (context, next) =>
{
    // 匹配你的大文件上传路径
    if (context.Request.Path.StartsWithSegments("/api/large-upload") 
        && context.Request.Method == HttpMethod.Post.Method)
    {
        using var bufferlessStream = context.Request.GetBufferlessInputStream(true);
        // 这里直接处理流，比如上传到云存储或者本地
        // ...处理逻辑...
        
        // 处理完直接返回，不用进入后续管道
        await context.Response.WriteAsJsonAsync(new { success = true });
        return;
    }
    
    // 非大文件请求，继续走正常管道
    await next();
});

ASP.NET Framework 用HttpModule #

public class LargeFileUploadModule : IHttpModule
{
    public void Init(HttpApplication context)
    {
        // 在请求开始阶段就获取流，避免后续触发缓冲
        context.BeginRequest += OnBeginRequest;
    }

    private void OnBeginRequest(object sender, EventArgs e)
    {
        var app = (HttpApplication)sender;
        var request = app.Context.Request;
        
        if (request.Path == "/LargeFileUpload.aspx" && request.HttpMethod == "POST")
        {
            // 获取无缓冲流，并存在Items里供后续页面/控制器使用
            var bufferlessStream = request.GetBufferlessInputStream(true);
            app.Context.Items["BufferlessUploadStream"] = bufferlessStream;
        }
    }

    public void Dispose() { }
}

然后在web.config里注册模块：

<system.web>
  <httpModules>
    <add name="LargeFileUploadModule" type="YourNamespace.LargeFileUploadModule" />
  </httpModules>
</system.web>

额外必须配置的项 #

不管用哪种方案，你还需要调整两个关键配置，避免IIS和ASP.NET的默认大小限制：

ASP.NET Framework #

在web.config里：

<!-- ASP.NET的请求大小限制，单位KB，这里设为最大int值（约2TB） -->
<system.web>
  <httpRuntime maxRequestLength="2147483647" />
</system.web>

<!-- IIS的请求大小限制，单位字节，这里设为20GB -->
<system.webServer>
  <security>
    <requestFiltering>
      <requestLimits maxAllowedContentLength="21474836480" />
    </requestFiltering>
  </security>
</system.webServer>

ASP.NET Core #

在Program.cs或者配置文件里：

// 配置请求大小限制
builder.Services.Configure<FormOptions>(options =>
{
    options.MultipartBodyLengthLimit = 21474836480; // 20GB
});

同时确保IIS的requestLimits配置和上面一样（如果部署在IIS上）。

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