如何在.NET Core中增大POST响应返回的数据文件大小限制

问题根因 #

ASP.NET Core框架默认存在响应体大小限制，同时所用的Web托管服务器（Kestrel/IIS/Nginx等）也普遍默认配置了最大传输数据阈值，文件体积超过阈值后请求会被直接中断，导致下载失败。

配置调整方案 #

根据你使用的托管环境选择对应配置即可：

• Kestrel 托管场景
  在Program.cs中添加Kestrel全局配置，调整最大响应体大小：

  var builder = WebApplication.CreateBuilder(args);
  builder.WebHost.ConfigureKestrel(options =>
  {
      // 按实际业务需求设置上限，示例值为200MB，单位为字节
      options.Limits.MaxResponseBodySize = 200 * 1024 * 1024;
      // 如需完全取消限制可设为null，生产环境不推荐该操作
      // options.Limits.MaxResponseBodySize = null;
  });
  

• IIS 托管/部署到IIS场景
  需要同时调整两处配置：
  1. 在Program.cs中添加IIS服务配置：

  builder.Services.Configure<IISServerOptions>(options =>
  {
      options.MaxRequestBodySize = 200 * 1024 * 1024;
  });
  

  2. 在项目根目录的web.config文件中添加IIS请求过滤配置：

  <configuration>
    <system.webServer>
      <security>
        <requestFiltering>
          <!-- maxAllowedContentLength单位为字节，示例值为200MB -->
          <requestLimits maxAllowedContentLength="209715200" />
        </requestFiltering>
      </security>
    </system.webServer>
  </configuration>
  

• 单接口单独配置
  如果不需要全局放开大小限制，仅针对该下载接口调整阈值，可以在接口Action上添加RequestSizeLimit特性，注意仍需同步调整对应Web服务器的大小限制：

  [HttpPost]
  [RequestSizeLimit(200 * 1024 * 1024)]
  public IActionResult ExportDocx()
  {
      byte[] file = makeNewDocx(_data);
      return File(file, "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "导出文件.docx");
  }
  

性能优化建议 #

当前实现是将完整docx文件加载到内存字节数组后再返回，大文件场景下会占用大量服务器内存，容易引发内存溢出问题。推荐改为流模式返回，无需全量加载文件到内存：

[HttpPost]
[RequestSizeLimit(200 * 1024 * 1024)]
public IActionResult ExportDocx()
{
    Stream docxStream = makeNewDocxStream(_data);
    return File(docxStream, "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "导出文件.docx");
}

只需改造makeNewDocx方法，直接返回写入了docx内容的流对象即可。

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