Angular上传至ASP.NET WebAPI：远程HTTPS服务器无法接收UploadProgress事件需改web.config？

针对你的问题，确实需要调整Windows Server上IIS的web.config配置，同时还有几个关键环节要排查，下面一步步说明：

1. 禁用IIS的请求缓冲（核心配置） #

当部署到IIS的HTTPS服务器时，默认的uploadReadAheadSize设置会让IIS在将请求传递给ASP.NET WebAPI之前缓冲整个上传文件，这会导致Angular无法实时捕获HttpEventType.UploadProgress事件——客户端会一次性把文件发送完，然后直接触发完成事件，中间的进度更新完全丢失。

在web.config的<system.webServer>节点下添加或修改：

<serverRuntime uploadReadAheadSize="0" />

注意：这个设置仅适用于IIS 7及以上版本，设置为0表示禁用请求预读缓冲，让WebAPI能实时接收上传的数据流，客户端就能正常触发进度事件。

2. 确保响应分块传输（辅助配置） #

虽然UploadProgress是客户端上传的进度，但如果服务器端的响应被缓冲，也可能间接影响事件触发。在web.config中添加分块传输头并禁用动态压缩：

<system.webServer>
  <!-- 保留你已有的其他配置 -->
  <httpProtocol>
    <customHeaders>
      <add name="Transfer-Encoding" value="chunked" />
    </customHeaders>
  </httpProtocol>
  <urlCompression doDynamicCompression="false" />
</system.webServer>

禁用动态压缩是因为压缩过程会缓冲响应内容，而分块传输头能确保服务器实时返回响应片段，避免整体缓冲。

3. 检查ASP.NET WebAPI端的代码配置 #

确保你的WebAPI上传方法没有手动缓冲请求内容：

• 如果你用的是ASP.NET Core，直接使用流式处理或IFormFile，不要将整个文件读入内存：

[HttpPost("upload")]
public async Task<IActionResult> Upload()
{
    // 流式处理上传内容，避免缓冲整个文件
    var stream = Request.Body;
    // 后续文件处理逻辑...
    return Ok("Upload completed");
}

• 如果是传统ASP.NET WebAPI（非Core），要确保HttpResponseMessage的BufferOutput设为false：

public async Task<HttpResponseMessage> Upload()
{
    var response = new HttpResponseMessage(HttpStatusCode.OK);
    response.BufferOutput = false;
    // 处理上传逻辑...
    return response;
}

4. 排查HTTPS相关的额外因素 #

HTTPS环境下的代理或TLS配置也可能导致缓冲：

• 如果服务器前端有反向代理（如ARR），要确保代理服务器也禁用了请求缓冲，开启分块传输支持。
• 检查Windows Server上的TLS版本设置，确保与Angular客户端使用的版本兼容，避免因握手延迟导致进度事件异常。

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