ASP.NET API请求截断问题排查求助

以下是针对Windows Data Center 2019上ASP.NET API大文件上传偶尔截断问题的排查步骤：

1. 验证ASP.NET与IIS的请求大小限制配置 #

首先确认所有层面的请求大小限制都已正确设置为20MB（20971520字节），避免因配置覆盖导致的截断：

• 传统ASP.NET（web.config）：

  <system.web>
    <!-- 单位：KB，20MB=20480KB，同时延长执行超时时间 -->
    <httpRuntime maxRequestLength="20480" executionTimeout="300" />
  </system.web>
  <system.webServer>
    <security>
      <requestFiltering>
        <!-- 单位：字节，20MB=20971520字节 -->
        <requestLimits maxAllowedContentLength="20971520" />
      </requestFiltering>
    </security>
  </system.webServer>
  

• ASP.NET Core（Program.cs/Startup.cs）：

  // 全局配置表单请求大小限制
  builder.Services.Configure<FormOptions>(options =>
  {
      options.MultipartBodyLengthLimit = 20 * 1024 * 1024;
  });
  
  // 或在控制器/Action上添加特性单独限制
  [RequestSizeLimit(20 * 1024 * 1024)]
  [ApiController]
  [Route("api/[controller]")]
  public class IssueController : ControllerBase
  {
      // ...
  }
  

同时检查是否存在局部配置（如特定路由的中间件）覆盖了全局限制。

2. 排查IIS应用程序池与连接设置 #

• 调整连接超时：在IIS管理器中，进入站点→高级设置→连接超时，建议设置为300秒（5分钟），避免大文件上传因超时被截断。
• 检查快速失败保护：进入应用程序池→高级设置→进程模型→快速失败保护，若短时间内出现多个错误，IIS会终止进程，可能导致请求中断。可临时禁用该功能测试是否解决问题。
• 调整队列长度：若应用程序池队列满，新请求可能被丢弃或截断，建议将队列长度调整至1000左右。

3. 排查网络层问题 #

• 抓包验证：在服务器端使用Wireshark抓取SSL解密后的流量（需配置SSL密钥日志），对比客户端发送的Content-Length与服务器实际接收的字节数，确认是否为网络丢包或中间设备截断。
• 防火墙与负载均衡检查：检查Windows Defender防火墙、硬件防火墙或前端负载均衡设备是否存在针对大请求的限制规则（如最大请求大小、超时时间），确保这些规则允许20MB的请求通过。
• SSL配置验证：确认Windows Server启用了TLS 1.2/1.3，禁用过时的SSL协议，避免因SSL握手或会话复用问题导致数据传输中断。

4. 分析应用与系统日志 #

• 捕获500错误的详细异常：在API中添加全局异常过滤器，记录异常的完整堆栈跟踪与消息，例如：

  public class GlobalExceptionFilter : IExceptionFilter
  {
      private readonly ILogger<GlobalExceptionFilter> _logger;
      public GlobalExceptionFilter(ILogger<GlobalExceptionFilter> logger) => _logger = logger;
  
      public void OnException(ExceptionContext context)
      {
          _logger.LogError(context.Exception, "请求处理失败，路径：{Path}", context.HttpContext.Request.Path);
          context.Result = new StatusCodeResult(StatusCodes.Status500InternalServerError);
      }
  }
  

  重点关注是否存在IOException、HttpRequestException等与请求体读取相关的异常。
• 检查Windows事件日志：查看事件查看器中的应用程序日志与系统日志，寻找IIS、ASP.NET或应用程序池相关的错误（如进程崩溃、内存不足、磁盘IO错误）。
• 监控服务器资源：当出现截断问题时，检查服务器的CPU、内存、磁盘IO使用率，确认是否因资源耗尽导致请求处理中断。

5. 验证请求体读取方式与编码 #

• 检查请求体读取逻辑：确保API读取请求体时使用了异步且完整的读取方式，例如：

  [HttpPost("ExecuteIssue_UploadImageV2/{id}")]
  public async Task<IActionResult> UploadImage(Guid id)
  {
      using var reader = new StreamReader(Request.Body);
      var body = await reader.ReadToEndAsync();
      // 处理请求体
  }
  

  避免使用同步读取或不完整的缓冲区读取。
• 编码与压缩验证：虽然请求头Accept-Encoding: gzip是针对响应的，但需确认客户端未错误压缩请求体，而服务器未配置对应的解压逻辑，导致请求体解析失败。同时验证base64编码的ImageData在传输过程中未被篡改或截断。

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