WebAPI文件上传报错：Bufferless模式下无法读取实体主体

嘿，这个问题我之前在做WebAPI文件上传时也踩过坑！咱们来理清楚问题出在哪，以及怎么解决：

你遇到的错误 "Unable to read the entity body in Bufferless mode. The request stream has already been buffered." 核心原因很简单：HTTP请求的数据流是单向、只能读取一次的。

你先调用了 Request.Content.ReadAsStringAsync().Result，这一步已经把整个请求的内容读完并消耗掉了请求流。等后面再执行 ReadAsMultipartAsync 时，请求流里已经没有内容可以读取了，自然就抛出了这个错误。

如果你是为了调试查看请求内容，别用 ReadAsStringAsync 这种一次性读完整个流的方式，试试下面两种方法：

• 方法1：用MultipartMemoryStreamProvider捕获内容（推荐）
  这个方法既能查看上传的multipart内容，又不会破坏后续的文件上传流程：

  // 先临时用内存流提供者捕获所有multipart内容
  var tempProvider = new MultipartMemoryStreamProvider();
  await Request.Content.ReadAsMultipartAsync(tempProvider);
  
  // 遍历查看每个部分的内容（调试用）
  foreach (var contentPart in tempProvider.Contents)
  {
      var contentText = await contentPart.ReadAsStringAsync();
      // 这里可以输出到日志或者调试窗口查看
  }
  
  // 正常处理文件上传——如果你不需要调试了，直接用你的streamProvider即可
  var result = await Request.Content.ReadAsMultipartAsync(streamProvider).ContinueWith<HttpResponseMessage>(t => {
      // 你的文件上传处理逻辑
  });
  

• 方法2：临时关闭Bufferless模式（仅调试用）
  如果你非要先读整个请求内容，可以修改WebAPI配置关闭Bufferless模式，但这会影响大文件上传的内存性能，只适合临时调试：
  在WebApiConfig.cs中添加如下代码：

  config.Services.Replace(typeof(IHostBufferPolicySelector), new DisableBufferlessPolicy());
  
  // 定义禁用Bufferless的策略类
  public class DisableBufferlessPolicy : IHostBufferPolicySelector
  {
      public bool UseBufferedInputStream(object hostContext) => true;
      public bool UseBufferedOutputStream(HttpResponseMessage response) => true;
  }
  

  调试完成后记得改回默认配置，否则大文件上传时容易出现内存溢出问题。

永远不要在处理multipart文件上传前，提前读取整个请求流！请求流是一次性的，一旦被消耗就无法再次读取。如果需要调试，就用专门的multipart流提供者来捕获内容，或者直接在文件上传的处理逻辑里添加调试日志。

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