ASP.NET 4.8 Web API多文件上传请求异常排查求助

1. IIS与ASP.NET并发及队列限制 #

• 检查IIS网站的最大并发连接数：在IIS管理器中右键网站→高级设置，查看“最大并发连接数”，若设置值过低（比如10），超出的请求会被拒绝或排队，导致部分请求无法到达控制器。
• 检查ASP.NET请求队列与线程限制：在web.config中查看httpRuntime节点的requestQueueLimit、maxConcurrentRequestsPerCPU、maxConcurrentThreadsPerCPU属性，若这些值被修改过小，会导致请求无法被及时处理，甚至被丢弃。
• 检查应用程序池队列长度：在应用程序池高级设置中查看“队列长度”，若队列满后新请求无法进入，会触发错误。

2. 前端请求层面问题 #

• 验证浏览器并发请求限制：多数浏览器对同一域名的并发请求数有限制（如Chrome默认6个），若前端同时发起15个请求，超出部分会被浏览器排队，若排队超时或出现网络错误，会返回500且服务器未收到请求。
• 查看前端错误日志：检查浏览器控制台中500请求的具体错误详情，确认是服务器返回的错误，还是请求被中断、网络层面的问题。

3. 服务器端日志与异常排查 #

• 记录全请求生命周期日志：在Global.asax的Application_BeginRequest事件中添加日志，记录所有到达服务器的请求，确认请求是否真的抵达服务器，还是在到达控制器前被拦截。
• 查看Windows事件查看器：检查“Windows日志→应用程序”中的ASP.NET错误记录，以及IIS日志（默认路径C:\inetpub\logs\LogFiles），日志中会包含500错误的细分代码（如500.19配置错误、500.0应用程序异常）及请求详情。
• 捕获控制器方法内异常：在UploadFile方法中添加try-catch块，记录异常信息，确认进入方法后是否有未捕获的异常导致500：

[HttpPost]
public async Task<Models.Uploads.UploadFileResponse> UploadFile()
{
    try
    {
        Utils.LogHelper.WriteToLogFile("Entered UploadFile method in file controller");
        return await _repository.UploadFileAsync(HttpContext.Current.Request).ConfigureAwait(false);
    }
    catch(Exception ex)
    {
        Utils.LogHelper.WriteToLogFile($"UploadFile error: {ex.Message}\nStack Trace: {ex.StackTrace}");
        throw;
    }
}

4. 文件上传相关限制 #

• 检查IIS文件大小限制：在web.config中，确认httpRuntime节点的maxRequestLength（单位KB）和system.webServer/security/requestFiltering/requestLimits节点的maxAllowedContentLength（单位字节）设置，若文件大小超出限制，请求会在到达控制器前被拦截，返回500且无方法进入日志。
• 检查请求超时设置：查看web.config中httpRuntime的executionTimeout属性，若文件上传处理时间超过该值，请求会被强制终止，导致500错误。

5. 应用程序池状态与权限 #

• 检查应用程序池回收设置：查看应用程序池的回收规则，若在批量上传过程中触发自动回收，会导致正在处理的请求失败，返回500。可临时禁用回收进行测试。
• 验证应用程序池身份权限：若上传文件需要写入磁盘，确认应用程序池的运行身份具备目标目录的读写权限，权限不足会导致上传失败，触发500错误。

6. 网络与系统层面限制 #

• 检查防火墙/代理设置：若服务器或前端与服务器之间存在防火墙、代理，可能限制了并发请求数，超出的请求会被拦截，导致服务器无法接收。
• 检查Windows TCP连接限制：查看系统的MaxUserPort和TcpTimedWaitDelay设置，短时间内大量请求可能导致端口耗尽，无法建立新连接，请求失败。

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